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preface 


This guide introduces you to methods for manipulating files 
on HP 3000 computer systems. It does not tell you every- 
thing you need to know about accessing files with your 
own programs or discuss disc file structure in detail but 
rather shows you which commands, subsystems, and utility 
programs can help you manipulate files and defines some 
basic terms relating to files. 


The guide assumes you have had some experience with data 
) processing methods and, specifically, with files. If you 
“don't know how to log on to MPE (HP 3000's operating 
system) and use MPE commands, read Section | of Using 
the HP 3000 before reading further in this guide. 











If you plan to use an IMAGE data base, you may find some 
parts of this guide helpful but the /WAGE Data Base 
Management Reference Manual contains most of the 

7} information you will need. 





For instructions on using files to compile and prepare pro- 
grams, read Using the HP 3000 and the appropriate 
programming language reference manual as well as this 
guide. 











A glossary is provided at the end of the guide - look there 
if you encounter unfamiliar terms while reading the guide. 





Part numbers for the manuals referenced are listed in 
Appendix A. 
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3000 system files 


Most people who have used computers think of a file as data stored 
on either a magnetic tape or a disc. 


As you begin using your 3000 system, you will find that MPE 
treats information being entered from any input device 


Magnetic Tape 


Card Reader Terminal 





or written to any output device 


Line Printer 
Magnetic Tape 
Terminal 








or stored on a disc 


Disc 


as a file. - 7 


Paper Tape 
Reader 





Paper Tape 
Punch Unit 


THE FILE SYSTEM 


All access to files is accomplished through a portion of the HP 
3000. Multiprogramming Executive operating system called the File 
System. Since the File System manages all input and output 
through files, you can access very different devices in a standard, 
consistent way. Access to data by a program may be 


device-independent |. 


This means each time you run a program, you can tell MPE where 
the file is and what its characteristics are by using a : FILE command. 


Suppose a program writes information to a file it calls OUTFILE. 
The data may be written to magnetic tape during one execution of 
the program and to a line printer during another execution. 


Change 
actual device Line Printer 
by using 







:FILE 


FILE 
SYSTEM 











PROGRAM 


Calls file system to 
generate output file 





The major characteristics of the device and type of access must also 
be considered; for example, a program cannot write to a card 
reader. 





The name by which the program refers to the file is its 


formal file designator |. 


The name by which MPE knows the file is its 
actual file designator |. 


For example, a program may refer to an output file as OUT123 (or 
a FORTRAN program may refer to an output file as FTN10). Be- 
fore you run the program you can use a :FILE command to equate ~~ 
the formal file designator (OUT123) to a particular device ee 


:-FILE OUT123; DEV=TAPE or :FILE FTN10; DEV=TAPE 
:-FILE OUT123; DEV=LP ~— or :FILE FTN10; DEV=LP 
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If you want to write output to a disc file, you can use the :FILE 
command to equate the formal file designator to an actual file 
designator (the name of an existing permanent or temporary disc 
file, or a new disc file). For example, to equate it to an existing 
permanent disc file named FILEXYZ you would use this command: 


:-FILE OUT123=FILEXYZ 
Unless you specify a device type, the default device type is DISC. 
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DEVICES 








When the system supervisor configures the system, each device is 


assigned a |device class name} and a {logical device number |. For 


example, the card reader may be in device class CARD and be 
assigned logical device number 7. 


When you tell MPE that you want to read data from a device hav- 
ing the device class name CARD, the data which is read from this 
device is considered a [| devicefile]. Each card that is read from the 
card reader is a record. If a program sends information to a line 
t printer, this data is also a devicefile. 








Line Printer 








records (lines) 









7j Although a disc drive is also a device, disc files are not called device- 
files in the MPE operating system. In fact, devicefiles are some- 
times referred to as non-disc files. 








In addition to one or more device class names and a logical device 
number, the system supervisor specifies characteristics for each de- 
vice in the system including the following: 





® device type and subtype (two system defined numbers that 
identify exactly what kind of device it is; for example, a hard- 
wired terminal versus a terminal connected through a modem). 





record width 

whether the device can accept jobs, sessions, or data that is not 
part of a job or session (using the :DATA command that is 
discussed later in this guide). 
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For the purposes of this guide, let’s assume our system is config- 





ured like this: i 
Device class: CARD ( 
Logical device: 5 
Device class: DISC Device class: SYSDISC 
Logical device: 2 Logical device: 7 
fis <a ol 


HP 3000 
Central 
Processing 
Unit 








Device class: TAPE, TAPE? 


Device class: LP 
Logical device: 7 j ass 


Logical device: 6 
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Device class: CONSOLE 
Logical device: 20 





Device class: TAPE, TAPE2 
Logical device: 8 Device class: TERM Device class: TERM 
Logical device: 21 Logical device: 32 


a 


{ 





In most situations, you can refer to these devices by either their 
device class names or logical device numbers but the device class 
name is least likely to change. 


eer 


how files are accessed 





All MPE file operations are performed through a set of system-sup- 

“Fy plied procedures (intrinsics). These intrinsics are described in the 

MPE Intrinsics Reference Manual. \f you are programming in 

“7D COBOL, BASIC, FORTRAN, RPG, or APL, you don’t have to call 

these intrinsics because the compiler (or interpreter) calls them for 

you when you use input-output statements of the language. Like- 

wise, when you use utility programs provided by the system, you 

do not need to be concerned about these intrinsics. However, it is 

_, important to be aware of the way files are opened and closed in 
| order to understand how to properly use the :FILE command. 





a 





The characteristics of a new file are determined at the time the file 
is opened and are defined by the parameters of the FOPEN intrin- 
sic. They may be modified by a :FILE command entered during 
the session or job that refers to the same formal file designator as 
the FOPEN intrinsic. The physical characteristics of an existing 
(old) disc file cannot be modified; for example, it’s record size or 
format. However, the :FILE command can be used to modify 
other characteristics such as file access restrictions. Illustrations of 
the :FILE command are provided in the examples which follow. 


The decision to keep or discard a file created by the FOPEN intrin- 
sic or an existing disc file is made when the file is closed. At that 
~, time the file may be saved as a permanent file or a session/job 
L temporary file or it may be deleted. The file’s disposition is speci- 
fied as a parameter of the FCLOSE intrinsic or a :FILE command 
parameter which may have the value: 





@® SAVE make the file a permanent disc file 


@ TEMP make the file a temporary disc file to be deleted at the 
end of the current session or job 


@ DEL delete the file. 
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A COBOL or BASIC program that performs operations on KSAM 
§ files must do so through calls to KSAM procedures which in turn 
' call the MPE intrinsics. 





file characteristics 
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A file consists of logically related records which in turn consist of Disc files may be divided into as many as 32 (16 for Pre- 
logically related data elements. Series Il systems). Extents allow you to use the disc more effici- 
ently by allocating disc space as it is needed and making it easier to 
find enough consecutive disc space to accommodate a large file. 
For example, a file consisting of 10,000 records may be divided 


<<a [] [] a > Data Elements into 10 extents, each consisting of 1000 records. You may request 
that only 1 extent of 1000 records be allocated at first. 


ie 
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Peripheral 
1/O 
Device 


Logical Record 


You need not be concerned with the actual physical location of the .— 
id Een File records or extents unless you are trying to optimize an application's ( 
Record 0 Record 1 Record N disc access. The space for a file can be allocated one extent at a 
time, as it is required. 


Logical records may be 
Logical records in disc and tape files may be grouped in © fixed length 
which are sometimes called physical records. Data is transferred to 
and from a device, one complete block at a time. Blocks for all 
other devices consist of 1 logical record per block. @ undefined length (not used for disc normally). 


@ variable length, or 


Records Blocks 
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Examples in this guide deal only with fixed-length records. See the 
MPE Commands Reference Manual or the MPE Intrinsics Refer- 
ence Manual for a description of variable or undefined length 
records. 


A file can contain ASCII (American Standard Code for Informa- 
tion Interchange) coded 


@ text 


@® source programs 


” @ job contro! commands (with or without data) 


or BINARY information such as 
® compiled and prepared (executable) programs 


® data. 


You will see examples of these files as you read further in this 
guide. 


The specification of a file as ASCII or BINARY does not perform 
any conversion of the data. ASCI! coded data may be stored ona 
BINARY format file and vice-versa. However, to avoid confusion 
this is not usually done. If you tell the system that a file is ASCII 


y format, it pads records preceding the end-of-file with blanks. If 
y you tell the system that a file is BINARY format, it pads records 


with zeros. 


EBCDIC or BCD coded data may be stored in either BINARY or 
ASCII files. 


You may access disc files sequentially or directly (by logical record 
number). 


FILE IDENTIFICATION 


A file may be identified by a name. Disc files are also identified by 
a system file label and may optionally be identified by user labels 
and a file code. 


A disc file name consists of at most 8 alphanumeric characters and 
must begin with an alphabetic character: for example, TESTFILE, 
INVENTRY, FILEZ, and MATLISTX. Devicefiles are sometimes 
referenced by special system-defined names that begin with a dollar 


sign ($). These files are called | system-defined files | and are discus- 


sed in the next section. 


File names may be qualified by the name of the group and account 
to which the file belongs as shown in the File Security section 
which follows. 


The system file label is maintained automatically by the system 
and contains descriptive information about the file. If you create a 
disc file with user labels you are responsible for the content of 
these labels. 


A file code is a number in the range of 0 to 1023 that identifies a 
group or class of files. The file code is saved in the system file label. 
File codes larger than 1023 are assigned special meanings by the 
system. (See the :BUILD command in Section I| of the MPE Com- 
mands Reference Manual for a list of these codes and their mean- 
ings.) The use of file codes in your own files is completely optional. 
If you do not specify one, it will be zero by default. They can be 
useful for an application; for example, to identify the specific type 
of information that a file contains. You can retrieve the value of a 
file code programmatically by calling the FGETINFO intrinsic or 
using the :LISTF command as shown later in this guide. 


using devicefiles 


Your interaction with devicefiles will usually consist of entering 


commands like these: 


:-FILE PRINTER; DEV=LP 


:-FILE XXXOUT; DEV=TAPE; 
REC=200,3,F, BINARY 


:-FILE XXXIN; DEV=CARD 


Tell MPE you are referencing a 
line printer by the formal and 
actual file designator PRINTER. 


Tell MPE you are equating the 
formal file designator XXXOUT 
to a magnetic tape device with 
fixed length records 200 words 
long, containing binary data and 
written with three logical rec- 
ords per block. 


Tell MPE you are referencing a 
card reader by the formal and 
actual file designator XXXIN. 


You may also want to reference one of the system-defined files: 
$STDIN, $STDINX, $STDLIST, S$OLDPASS, $NEWPASS, or 


$NULL. 


:-FILE XXXOUT=$STDLIST 


:FILE FTNO6=$NULL 


Tell MPE to display the output 
file referenced in your program 
as XXXOUT on the $STDLIST 
device. 


Tell MPE to discard all data writ- 
ten to the file named FTNO6 by 
writing it to the system “ghost 
file,” $NULL. 
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System defined files are actually just reserved words that refer to a 
specific type of system file. 


@ $STDIN 


@ $STDLIST 


e $OLDPASS 
SNEWPASS 


@e@ $NULL 


refers to the device that you used to initiate your 
current session or job. The device is normally a 
terminal for a session and a card reader for a job. 
(SSTDINX is a special $STDIN file that can ac- 
cept most MPE commands as data. See the MPE 
Commands Reference Manual for a complete 
description.) 


is the device designated as the session or job out- 
put device, the device MPE uses to respond to 
your commands. This device is normally a termi- 
nal for sessions and line printer for jobs. 


reference special temporary files. You will find 
an example of their use later in this guide. 


is a file designator that is used to tell MPE to 
read from or write to a non-existent file as 
though the input-output operation were success- 
ful. This file is usually used to discard output. 


Here are some things to remember about devicefiles: 


@ A devicefile as identified by a specific file designator exists only 
temporarily, from the time you open the file until you close it. 


@® With the exception of magnetic tapes, devicefile blocks contain 
only one logical record. 


@ Access to a device file is always sequential. 


@® You must specify the device class when using a :FILE command 
to define a devicefile, since the system default device class is 
DISC. (If an application program referencing: the file specifies 
the device class when the file is opened, it can be omitted from 
the :FILE command.) 
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You must protect devicefile data since the system does not pro- 
vide security for data contained in cards, on magnetic tape, or 
line printer listings. 


Non-sharable devices such as card readers and line printers may 
be [spooled]. Spooling permits more than one job or session to 
gain access to a device without waiting by copying the data 
coming from or going to a spooled device onto a disc until the 
device is free, and then completing the input-output operation 
requested. 


Device class names are determined by the system manager and vary 
from installation to installation. Thus, the line printer may be call- 
ed LP on one system, PRINTER on another. Before you attempt 
to use these names, find out what device class names have been 
defined for your installation. 
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file security 


Devicefile data such as that stored on magnetic tape or cards is 
controlled by those who generate it. The data can be locked in 
cabinets and physically protected from unauthorized access. Disc 
file data, on the other hand, resides on one or more discs shared by 
all the system’s users. In order to protect the files you create, MPE 
manages the system resources and controls access to the system 
through accounts, groups, and user names. Each file belongs to a 


[ group | within an [account | and to the [user], or member of the 


account, who creates the file. To further protect a file, the creator 


may assign a to it. 


The file system determines whether or not to grant access to a file 
when a request is made. You must meet the security requirements 
at three levels, the 


® account level 
@ group level 


@ file level 


The creator of a file has additional capabilities such as altering the 
file’s lockword. 


The HP 3000 account structure helps you protect the files you cre- 
ate and provides a means of controlling and monitoring system 
usage. You can define a very simple structure initially; for example, 
your system may initially consist of the SYS account for general 
use — you can add to its complexity as you become familiar with 
the various options and want to use them. 


Each account can use its groups for a different purpose. In the 
example: 


@ The FINANCE account keeps files related to different divisions 
of the company in separate groups. 


® The INVENTRY account separates files by type. All data files 
are kept in a group named DATA; all program source files in a 
group named SOURCE; all job control files in the JOBCONTR 
group; and all utility routines in the UTILITY group. 


@ The PAYACCT separates files used by one project group from 
those used by another project group. 


S335 





ACCOUNTS AND GROUPS 


Payroll Department’s Account 


ye a 


Manufacturing Department's Inventry 
Account 


ae = Sa Se SS 


Finance 
Finance Department’s Account 





The accounting structure illustrated here consists of three accounts: 


@ PAYACCT ee 
@e@ FINANCE ae 
e@ INVENTRY 

A SYS account must exist as part of the system also. i. 
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The diagram below illustrates the protective barriers that you 
may establish for a file. These levels form a hierarchy or series of 
filters. Before you can access a file, you must first pass the ac- 
count level, then the group level, and finally the file level of security. 


Account Level Security 


Who can read from 

Who can append to 

Who can write to 

Who can lock 

Who can execute program 


files in this account? 


Group Level Security 


Who can read from 

Who can append to 

Who can write to 

Who can lock 

Who can execute program 
Who can save 


account ree ; 
files in this group? 


File Level Security 


Who can read from 

Who can append to 

Who can write to 

Who can lock 

Who can execute a program in 


this file? 


What is the Lockword? 





ANY -— any system user? 
— an account user? 


— an account librarian? 


GU — a group user? 
GL — a group librarian? 
CR — the file’s creator? 
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You establish your log-on account and log-on group when you ini- 
tiate a session 


‘HELLO MEMBER1.PAYACCT, GROUP1 
or a job. 
-JOB MEMBER1.PAYACCT, GROUP1 


user name account name group name 


When the account manager defines your user name, he may option- 


ally assign a to you. If you do not specify a group 


name when using the :HELLO or :JOB commands, your log-on 
group is the same as your home group. 


MEMBER 1’s home group is GROUP1. 
‘HELLO MEMBER1.PAYACCT 


:-FILE INFILE = FILEX 


If you do not have a home group, you must include a group name 
in the :HELLO or :JOB command. If you have a home group and 
specify some other group when you log on, you are considered to 
be a group user (GU) of both your home group and your log-on 
group. However, you must indicate when you want to use a file 
that is not in the log-on group by qualifying the file name as shown 
below. 


If you do not initiate your job or session with the names of the 
account and group to which a file belongs, you may be able to gain 


access to the file by using a | fully-qualified file name | when you 


reference it. For example, 


:FILE INFILE = FILEX.GROUP1.PAY ACCT 


File name qualified by group and account names. 


If you are using the account but not the group to which the file ® Group Level 


belongs, you only need to qualify the file name with the group 
name. 


MEMBER1 whose home group is GROUP1 logs on to GROUP2. 
‘HELLO MEMBER1.PAYACCT, GROUP2 


group users are allowed to save files in the PUB 


group. 


‘FILE INFILE = FILEX.GROUP' 
by group users, and they may acces 


MEMBER1 qualifies the file name with the name of his home any way. 


group. @ File Level 


Files in any other group may be accessed only 


s them in 


Any user who passes the account and group 


levels of security can access the file in any way 


Usually you will be logged on to or running jobs in the file’s 
account and group and can simply use the file name (and its lock- 
word if one is assigned). 


:-FILE INFILE = FILEX 


one is defined. 


Here is asummary of these provisions: 


Account Level Group Level 


It is also possible to gain access to a file by asking the file’s creator 


to temporarily release (turn off) the file’s security provisions using SYS Account Other Accounts PUB Group Other Groups 





the :RELEASE command. The creator then must use the :SECURE 3 a Z 2 

command to restore the file’s security provisions when you are a a se 
finished using it. A AC AC AL or GU 

The security restrictions for an account are defined by a system X ANY AC 

manager when the account is opened and may be altered by asys- 5 ———— AL or GU 

tem manager. The security restrictions for a group are defined, and 

may be altered, by an account manager. When you create a file, R = read files 


A = add data records to file but cannot delete or 


its security is defined automatically by a set of default restrictions. 
alter existing data 


You may alter these restrictions by using the :ALTSEC command. 


If no security restrictions are specified when the account and group 
are defined—by default, the security requirements are the following: 


Only account members can access the files in 
the account and they are granted all types of 
access. 


@e Account Level 
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W = add, delete, or change data or delete files 
L = lock files 

X = run programs stored in files 

S = save permanent files within a group 


AC = account user 
GU = group user 


ANY = any user 
AL = account librarian 


but they must provide the correct lockword if 


File Level 


All Files 














Files in the PUB group may be read, and pro- 

gram files in this group may be executed, by 
any user who passes the account level of secur- 
ity. Only account librarians and group users are 
allowed to append to, write to, and lock files in 
the PUB group. Only account librarians and 


' 
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CREATOR CAPABILITIES 





The following capabilities are granted only to the file’s creator: 
@® renaming the file 

changing the lockword of a file 

altering the file level security restrictions 


releasing or suspending the file’s security restrictions 


securing these restrictions again. 


The creator can alter the file level security restrictions in such a 
way that only he or she has certain types of access to the file. 


For more information about defining accounts and groups, see the 
System Manager/System Supervisor Reference Manual. 
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KSAM files 


In addition to regular disc files, you may want to use the file 
handling capabilities available through the KSAM/3000 (Keyed 
Sequential Access Method) software.” KSAM offers all the MPE 
file system capabilities and in addition makes it possible to create 
and maintain disc files whose records can be accessed by the value 
of key fields within the data records. 


A KSAM file is organized into two distinct MPE files, a data file 
and a key file. The key file contains only key entries, the data file 
only data. Each record in the data file contains at least one item 
that is designated as a key. The value of each key is duplicated in 
the key file where all keys are ordered in ascending sequence. The 
key file maintains the logical order of the records even though they 
may not be stored in sorted order in the data file. 


Although a KSAM file consists physically of two separate files, a 
data file and a key file, it is treated as one file for most purposes. 
For example, reading from a KSAM file in primary sequence is 
equivalent to reading sequentially from a non-KSAM file. Similarly, 
creating the data file portion of a KSAM file is equivalent to creat- 
ing a non-KSAM file. 


Most of the examples in this manual illustrate MPE file operations 
although there are a few examples of KSAM file manipulation. 
The major differences in manipulating MPE and KSAM files are: 


@ When you create, rename, save, or delete a KSAM file, you must 
use the utility program KSAMUTIL rather than the MPE com- 
mands. 


@ When you use the FCOPY utility program, you may use some 
special FCOPY parameters that relate only to KSAM files. 


There are many examples of using KSAM files in the KSAM/3000 
Reference Manual and the RPG/3000 Compiler Reference and Ap- 
plication Manual. Consult these manuals for detailed information 
about KSAM files. 


* Available only on HP 3000 Series I! Computer Systems. 
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as you read the examples... 


Note that the methods illustrated are not the only ones for accom- 


plishing the tasks. When you are familiar with the system you may 
find other ways that you prefer to accomplish some of the tasks. 


You can determine syntax rules for the commands illustrated by 
following the spacing and punctuation shown in the example. If 
you want complete syntax rules, consult the appropriate reference 
manual for the commands or subsystems being illustrated. In gen- 
eral, spaces are allowed between parameters but not in the middle 
f parameter values such as files names or reserved words. If you 
are unsure of a syntax rule, it is usually safe to experiment if you 
are not operating in production mode. 


To distinguish user responses from system prompts and messages 
in the examples, user input is printed in blue. 


If you decide to try some of these examples and an error occurs, 
you may see something like this displayed on your terminal: 


INVALID FILE REFERENCE CFSERR 54) 


If a file error occurs before a file is successfully opened, you may 


., see a message like this: 






"¢-F-1-L-E---1-N-F-0-R-M-A-T-1-O-N---D-1-S-P-L-A-Y* 


' ERROR HUMBER: Se 
' BLOCK NUMBER: 0 


RESIDUE: 0 ' 
NUMREC: 0 : 


error 
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In this case, look up the error message number in Table 2-7 of the 
Error Messages and Recovery Manual. Usually the utility program 
you are running allows you to continue after a File Information 
Display is printed, but you must determine the cause of the error 
and correct it. 


If an error occurs after a file is open, the File Information Display 
provides more information about the file: 


file name 


-F-1-L-E---I-N-F-O0-R-M-A-T-1I-0-N---D-1I-S-P-L-A-Y+ 
FILE NAME 1S IN.PUB.TECHPUBS” 


+ 
! : 
t FOPTIONS: NEW,A,*®FORMAL#,F,N,FEQ : 
' ADPTIONS: INPUT ,SREC ,NOLOCK ,DEF ,BUFFER : 
t DEVICE TYPE: 0 DEVICE SUBTYPE: 3 ‘ 
' LDEV: 17 DRT: 12 UNIT: 1 ! 
! RECORD SIZE: 256 BLOCK SIZE: 256 CBYTES) ! 
' EXTENT SIZE: 128 MAX EXTENTS: 8 ‘ 
! RECPTR: O RECLIMIT: 1023 : 
' LOGCOUNT: O PHYSCOUNT: 0 ' 
' EOF AT: 0 LABEL ADDR: %02100060123 ! 
' FILE CODE: 0 ID IS MAC ULABELS: 0 ! 
' PHYSICAL STATUS: 1111000000000001 : 
' ERROR NUMBER: 40 RESIDUE: 0° ! 
! BLOCK NUMBER: 0 NUMREC: 1 : 


error 


Until you gain more experience with the system, look up the error 
number in Table 2-7 of the Error Messages and Recovery Manual. 
Later, you may find the other information useful. It is described in 
Appendix A of the Error Messages and Recovery Manual. 


Now, let’s begin. 


defining accounts, groups, and users 


The system manager first creates an account. In this example, an 
account is set up in the standard way with no special capabilities or 
restrictions. Each account must have an account manager. A PUB 
group is automatically created. 


>HELLO MANAGER.SYS =n System manager logs on to the system. The system prompts for the 
ACCT PASSWORD? password. 
MISHTO 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


The system prints log-on information. 
sNEWACCT PAYACCT ,MANAGER (=m System manager defines a new account named PAYACCT with 
BYE account manager named MANAGER and then logs off the system. 


CPU=1. CONHECT=1. MON, JAN 9, 1978, 8:03 AM 





The account manager may now define groups and users. In this ex- 
ample, the account manager defines a group and user with standard 
capabilities and restrictions with the exception that a home group 
is assigned to the user. 





sHELLOD MANAGER.PAYACCT (=m Account mariager logs on to the system. 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


><NEWGROUP GRODUP1 (=m Account manager defines new group named GROUP1. and a new 
s<NEWUSER MEMBER1; HOME=GROUP1 user named MEMBER1 whose home group is GROUP1. The new 
sHELLO MEMBER1 .PAYACCT user may now log on with a username and account name. 


ee 


ADDITIONAL INFORMATION: 
System Manager/System Supervisor Reference Manual (Section IV and V) 
MPE Commands Reference Manual (Section III) 
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creating a disc file (using :BUILD) 


You can use the :BUILD command to create a disc file immedi- 
ately. If you want to verify that you created the file, you can use 
the :LISTF command. 








:sBUILD FILEONE Gam Creates a permanent disc file named FILEONE in your log-on or 
eLISTF — home group. 
Pa " Peas Lists all permanent files in your group. 
“venames 
FILEN ee I i 
i Doatas FILEONE XFILE 
‘LISTE FILEDNE vc ze Displays detailed information about FILEONE. 
3 ACCOUNT= PAYACCT GROUP= GROUP 
| PILEMAME CUDER  ~- reo eee LOGICAL RECURD----------- wae Se Sa BEE 
r Sslizt TYP EGF LIMIT R/B SECTORS #X MX 
r FILEONE 128W FB 0 1023 1 123 1 SB 77? 
| \ Lo / \.. data / ; / / 
filename maximum sectors 
F . file size in extents 
| poked eo end-of-file in records use alloca- 
in words is currently ted and 
in record @ allowed 
| ) blocking factor 
i A filename may be from 1 to 8 alphanumeric characters. The first ® blocking factor of 1 (1 logical record is transferred to or from 
: character must be alphabetic. the disc at a time) 
® 8 extents (the file is divided into 8 sections or extents, in this 
j Since all optional ParQeEiEss are omitted in the :BUILD commana case, each containing 128 contiguous sectors or physical records) 
shown in the example, the file assumes the default characteristics: 
@ 1 extent is allocated initially 
Jj @® 128 word or 256 character (byte) logical records 
| @ the file code is O 


@ fixed length records 
¥ @ 


: no carriage control information is to be provided when the file 
binary format oe 


€ 


PRE PA Tiles a VES apie Reeaees The following :BUILD command creates a file with these same 
characteristics: :BUILD FILEONE; REC=128,1,F,BINARY; 
NOCCTL; DEV=DISC; CODE=0; DISC=1023,8,1 


BE H 
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Some users prefer to specify all the parameters of a command, even 
though they are using the default values, in order to document the 
characteristics of the file. 


This is particularly useful when a command is part of a set of job 
contro! commands executed in batch mode on a production basis. 


The TEMP; parameter of the :BUILD command has been omitted 
in both examples; therefore FILEONE is a permanent file. It is 
saved immediately and retained after the session or job terminates. 


The :BUILD command 
@ allocates space for the file on the disc 
® sets an end-of-file pointer to the beginning of the file. 


If you try to read the file, you will be notified that it is empty. It 
is ready to have data entered into it. 


The :LISTF command displays information about files. 


@ if no parameters are specified, it lists the names of all perma- 
nent files in your log-on group. 


®@® (If the file name, a comma, and a 2 are specified, it lists informa- 
tion about the named file. Less information is displayed if you 
specify 1, instead of 2. 
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You cannot create a file in an account unless it is the 
account in which you are running your session or job. 


You can create a file in a group that is not your log-on 
group, if the security provisions of that group allow users 
who are not logged on to the group to save files in the 
group, or if it is your home group. 





ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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creating a disc file with specific characteristics 


Usually you will want to specify some special characteristics for 
the file you are creating - for example, a particular record size or 
format. 





Minus sign indicates quantity or length is in characters 
(bytes not words) 


sBUILD FILETWO; DISC=200,2; REC=-132,,,ASCII =m Create a disc file named FILETWO with 200 rec- 





‘LISTF FILETWO,1 ords, each 132 characters long, ASCII format. The 
‘accounr= PAYACCT GROUP= GROUP1 parameters file is divided into 2 extents; by default, 1 extent is 
omitted 
allocated. 
PILAR. £105 sore reese LOGICAL RECORD-------- 
Slice 1¥?F EDF LIMIT 
FILETWO 132B FA 0 200 
After you use FILETWO to store ASCII information, a physical much better to design the file with 128 character records and a 
record might look like this: blocking factor of 2 (or a multiple of 2). Then the logical records 


and disc sector would look like this: 


a ncaa we aria Be 
25341 Med-Supply Co...... 


oe oe ee 
of data of unused space 
in sector 





—@§\{_—_- 128 characters ———__——_—> 128 characters ———> 


of data of data 


132 + 124 = 256 characters (bytes) in disc sector 
128 + 128 characters (bytes) in disc sector 


Since the parameters are omitted, the blocking factor is 1 and the 

records are fixed length by default. Thus, 1 fixed length record is | And the :BUILD command would look like this: 

to be moved to the buffer at a time and each disc sector contains -BUILD FILETWO; DISC=200,2; REC=-128,2,,ASCII 
only 1 logical record. In order to conserve disc space, it would be 


ADDITIONAL INFORMATION: 
MPE Commands Reference Manual (Sections VI and VII) 
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creating a disc file while a program is executing 


You can create a file at the time your program opens the file by 
using the :FILE command with the NEW parameter. 


EW; REC=40,16, 


-FILE OUT=FILEONE, 
-RUN APPLICN 





In this example: 

® the logical record length is 40 words or 80 characters 
@ the blocking factor is 16 

® the format of the data is ASCII 

e 


the SAVE parameter makes the file a permanent one. 


Although it is possible to determine the characteristics of a 
file created with the :BUILD command by examining the param- 
eter values supplied with the command and knowing the default 
values for the optional parameters, it is not as simple to do this 
with the :FILE command. The type of file that is created depends 
not only on the :FILE command default values but also on the 
programming language used. If a :FILE parameter is omitted, and 
the program or compiler does not specify the parameter value, the 
MPE default values are used. For example, if APPLICN is aCOBOL 
program and the system-file-name in the ASSIGN clause of the 
SELECT statement does not specify a /fi/esize, the COBOL compiler 
specifies a file size of 10000 records. If you omit the DISC= 
numrec parameter from the :FILE command, the file is created 
with 10000 records rather than 1023 (the system default). 
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SAVE = When the APPLICN program opens a file it calls 


If APPLICN is an RPG program, the fi/esize is 1023 (the system 





OUT, create a new permanent disc file named 
FILEONE. 


default) since RPG does not allow you to specify the file size 
within the program. 


If you only specify :FILE OUT = FILEONE, NEW, the system de- 
faults for a complete :FILE command are: 


:-FILE OUT = FILEONE, NEW; REC = 128, 1, F, BINARY; 
NOCCTL; DEL; DEV = DISC; CODE = 0; DISC = 1023, 8, 1; 
ACC = IN; BUF = 2; SHR; NOMULTI; NOMR; WAIT 


Note that if you do not specify whether a file is NEW, OLD, or 
OLDTEMP, FORTRAN opens the file as a NEW file. If you want 
to reference an existing disc file you must specify OLD for a per- 
manent file and OLDTEMP for a temporary file. 


In the previous example, the SAVE parameter is used to override ( 


the DEL default for files whose domain is NEW. 
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lf file characteristics are specified in the program that opens the 
file, the system defaults are not used, and in some cases, the pro- 
gramming language has its own file characteristic defaults. This 








File Description 
(FD) specification 


File Description 
(FD) statement 
RECORD CONTAINS n 






(80 bytes default) 


FD cols. 20-23 and 
24-27 (1 default) 


BLOCK CONTAINS n 








RECORDING MODE [Sn 






(F default for disc) 


SELECT statement 
system-file-name 
(ASCII default) 





BINARY or ASCII; 





Control Record 
specification carriage 
control then CCTL 


SELECT statement 
system-file-name 
(DISC default) 


SELECT statement 
system-file-name 
(10,000 default) 


SELECT statement 
system-file-name 
(NOCCTL default) 


COTL or NOCCTL; 


DEL or SAVE or 
TEMP; 








FD cols. 40-46 
(DISC default) 











DISC=numrec, 







FD cols. 68-69 










Depends on file type 
FD col. 15 and col. 66 


ACC=IN or OUT OPEN statement 
or UPDATE or 
OUTPUT = OUT 


I-O = UPDATE 





APPEND or INOUT; 






SELECT statement 
RESERVE clause 










BUF=numbuffers; 


if INPUT then SHR If locking, SHR else 


EXC or EAR or SHR 









Hf 





If you use the SYSTEM numeric variable, “FILE . 


a. 


table indicates how the characteristics are determined according to 
the language in which the program is written: 


128 
1 
F 
BINARY 


NOCCTL 


FORTRAN 


128 if fixed-length 


V for sequential 
F for direct access 


BINARY except 
FTNOS5, FTNO6 


NOCCTL except 
FTNO6 





DISC except 
FTNOS5, FTNO6 





BUF=2 


8 
1 
INOUT 


EXC 


...’’ statement, the parameters you specify will determine these file characteristics. 


ASSIGN statement 
restriction param- 


eter (INOUT de- 





ASSIGN statement 
restriction param- 


eter (EAR default) 





The MULTI/NOMULTI, MR/NOMR, and NOWAIT/WAIT param- 
eters are used in advanced applications and are explained in the 
MPE Command Reference Manual. 


-BUILD 


Allocates space for a new disc file, places the file name ina di- 
rectory, initializes the file to blanks (ASCII) or zeros (BINARY), 
writes an end-of-file mark at the beginning of the file and sets 
the file pointer at the beginning of the first record. 


The file is a permanent file by default but may be session/job 
temporary if you specify TEMP. 


What are the advantages and differences between the :BUILD and 
-FILE commands? 
:-FILE name, NEW 


Performs the same operations as the :BUILD command but does 
so when the program opens the file. 


By default (DEL) the file will not be saved but may be saved as 
a permanent or session/job temporary file if you specify SAVE 
or TEMP. 








The :FILE command’s primary purpose is to change a file’s charac- 
teristics, overriding the characteristics defined in a program when 
the file is opened and closed. 


You can equate the formal file designator used in the program to 
an actual file designator, change the file code, or change most of 
the characteristics shown in the preceding table of languages. 


You cannot change characteristics recorded in the label of an exist- 
ing file. These characteristics include the file size, record size, and 
block size. 


ADDITIONAL INFORMATION: 


BASIC Interpreter Reference Manual 

MPE Commands Reference Manual (Section V1) 
COBOL/3000 Reference Manual 

FORTRAN Reference Manual 

RPG/3000 Compiler Reference and Application Manual 
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The :FILE command is also used to: 


® define devicefiles 
:-FILE PRINT; DEV=LP 


@ provide special run-time file control; for example, input/output 
access and sharing the file 
-FILE XXX; ACC=INOUT; SHR 


@ equate a file to a system-defined file 
‘FILE XXX=$NULL 


@ back reference another :FILE command. 
‘FILE XXX=*YYY 


(Examples of this technique appear later in this guide.) 
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creating a disc file by copying another file 


FCOPY, the file copier utility program, allows you to create a new 
file and copy information to it from an existing file. 





éa== Run FCOPY program. 
(Program is in PUB group of SYS account.) 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 


:RUN. FCOPY.PUB.SYS 


>FROM=EMPLOYEE; TO=EMPFILE; NEW (== Copy contents of EMPLOYEE file to new file named EMPFILE. 


EOF FOUND IN FROMFILE AFTER RECORD 19 
FCOPY indicates that end-of-file has been encountered and tells 


20 RECORDS PROCESSED ##%# OQ ERRORS how many records have been copied. 

SEV IT = Terminate FCOPY execution. 

END OF PROGRAM 

-LISTF EMPLDYEE,2 (= List information about EMPLOYEE file 

ACCOUNT= PAYACCT GROUP= GROUP1 

FrLeviane UE =SSSeen ere < LUGiCAL RECURD----------- -<—-=SPALE*<<= ACU 
Size TYP EDF LIMIT R/B SECTORS #X MX 

EMPLUYEE 108B FA 20 20 16 re 1 | 229 

sLISTF EMPFILE,2 ca List information about new file. 

ACCOUNT= PAYACCT GROUP= GROUP1 

FILENAME CURE <—<<<<<8"-+= LOGICAL SECURD----------- oi SPACE === AEG 

SIZE TYP EDS LIMIT R/B SECTORS #X MX 


EMPF ILE 108B FA 20 ec0 616 at 1 @t YP? 





As you can see from the :LISTF output, the new file has the same FCOPY, like MPE, references the first record as record number O. 
characteristics as the original file. FCOPY gives the TO-file the Therefore, record 19 is the 20th record copied. 

characteristics of the FROM-file unless you specify otherwise by 

using a :FILE command as shown in some of the examples that 

follow. 

To make an FCOPY command easier to read, you may include ADDITIONAL INFORMATION: 

blanks between the elements. FCOPY Reference Manual 
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creating a Tile with the editor 


a“ 
“a 3°59 


You can create files of ASCII data with the Editor, EDIT/3000. 
This technique is often used to create source programs and job 
control command streams. 





<= |nitiate execution of Editor by entering the MPE :EDITOR com- 
mand. 

HP32201A.5.01 EDIT/3000 TUE, JAN 18, 1977, 8:27 AM 

€C) HEWLETT-PACKARD CO. 1976 


. EDITOR 


y ADD (== Request to add lines to the work file Editor automatically creates. ( 
1 TEXT OF FIRST RECORD IN FILE (= Enter data when Editor prompts for a line (or record) 
Ss TEXT OF SECOND RECORD IN FILE 
3 ‘ 
To stop adding lines, press control key and Y key simul- 
taneously. 
/KEEP EDITFILE,UNN = Save work file contents in file named EDITFILE omitting line 
sERTT numbers (unnumbered). Terminate Editor. 
IF IT IS OK TO CLEAR RESPOND “YES" 
CLEAR? YES (== If the work file can be cleared, respond with yes. 


END OF SUBSYSTEM 





The file has the following characteristics: @ ASCII format [ 

@ 72 character records (a default value which you can modify) @ the file size is equal to the number of records you create 

@ fixed length records (by default. You can request variable length @ the blocking factor, number of extents, and number of extents L 
records.) allocated vary depending on the file and record size L 


| 


Cc 


anal 
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To create a file with a different record size, use the Editor com- 
mand SET LENGTH=n. 





>EDITOR 


APS2201h.5.01 EDIT/3000 WED, JAH 19, 1977, 11:13 AM 
CC) HEWLETT-PACKARD CO. 1976 


/SET LENGTH=80 ,RIGHT=80 (== Define a line (record) length of 80 characters, and right margin of 
/ADD 80 characters. Add lines to the work file. 

1 'JOB MEMBER1 .PAYACCT 

= ('CDOMMENT #322 ## 22 RRR RRR RBS 

3 'COMMENT ACCOUNTS RECEIVABLE UPDATE 


You can add records to the file later by using the Editor TEXT and ADD commands. 


>-EDITOR 


HP32201A.5.01 EDIT/3000 WED, JAN 19, 1977, 11:25 AM 
CC) HEWLETT-PACKARD CO. 1976 


/TEXT EDITFILE,UNN €== Move contents of EDITFILE into the work file. 
/LIST LAST (em List the last line in the file. 

46 THIS IS THE LAST RECORD IN THE FILE 
/ADD = Add lines following the last line. 

+? NEW DATA ADDED TO FILE 

48 

49 

50 re (=m Enter Control Y. 
/‘K EDITFILE,UNN em Save the work file in EDITFILE. 
EDITFILE ALREADY EXISTS - RESPOND YES TO PURGE OLD AND THEN KEEP 
PURGE OLD?y Qa A new EDITFILE is created and the previous one is deleted. Ter- 
JE minate Editor. 


IF IF 15 OK TO CLEAR RESPOND “VES” 


— 
- The Editor commands may be abbreviated, for example, K for 


KEEP and E for EXIT or END. 
ADDITIONAL INFORMATION: 
EDIT/3000 Reference Manual 
Using the HP 3000 (Section |) 
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creating a temporary disc file 


When you create a file with the :BUILD command, it is a perma- ( 
sBYUILD FILETEMPs TEMP = Create a temporary file named FILETEMP. 


nent file unless you include the TEMP parameter. 
‘LISTE FILETEMPs2 ems Try to list information about the file. Since the file is not a per- r 





manent file it is not in the system file directory. 
NONEXISTENT TEMPORARY FILE CFSERR 53) 


-BUILD FILETEMP: TEMP Gx However, if you try to create another temporary file with the 
same name you cannot since the filename is in the session/job 


temporary directory. 
DUPLICATE TEMPORARY FILE NAME CFSERR 101) ( 
HELLO MEMBER1.PAYACCT 


when you enter a new :HELLO command.) 
CPU=e2. CONNECT=11. MON, JAN 9, 1978, 2:20 PM 
HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


Now you can create a file with the same name since all temporary 


r 
<= Initiate a new session. (Current session is automatically terminated [ 
files are deleted when a session (or job) terminates. 





s<BUILD FILETEMPs; TEMP If you want to delete (purge) the file before the session terminates 
sPURGE FILETEMP, TEMP you use the :PURGE command with the TEMP parameter. 
( v 

You can also create a temporary file at the same time the program [ 
opens the file by using the :FILE command, omitting the SAVE 
parameter and using the TEMP parameter. [ 
iE en nn a i ne 
sFILE OUT=FILETEMP,NEWs; TEMP (em Equate OUT file referenced in program to temporary file named t 
sPURGE FILETEMP, TEMP FILETEMP. If you try to delete the file the system tells you it can- 
NONEXISTENT TEMPORARY FILE CFSERR 53) not find a temporary file with that name. When you use the :FILE L 
-RUN APPLICN command to create a file, you must access that file with a program | 

. or it will not be created. - 
-PURGE FILETEMP, TEMP a After the program executes, the file exists. (You would not usually & 
: bother to delete a temporary file as shown in this example.) 
sa SSeS DAR Omer Ti I ai SAC cv PRES MPR cra SG ESN SEA ENR SAR 90M ee USES SSRN Nes Oe eM ao SUBTLE SEMI L. 
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However, if you change your mind and want to make a session/job if you do not specify TEMP or SAVE with the :FILE command, 

temporary file a permanent one, you can use the :SAVE command. the file is deleted when the APPLICN program closes it since the 
default for this parameter is DEL (delete the file). 

For example: 


SAVE FILETEMP 





>sFILE OUT=FILETEMP,NEW = Equate OUT file to a new file named FILETEMP and execute 
>RUN APPLICN APPLICN program. 


a 


>PURGE FILETEMP, TEMP em When program closes the file, it is deleted - therefore, it does not 
NONEXISTENT TEMPORARY FILE CFSERR 53) exist when the program terminates. 





Job/session temporary files are catalogued in the Job Temporary 
File Directory. The files in this directory exist in the job/session 
file domain. Permanent files are catalogued in the System File Di- 
rectory and exist in the system file domain. You may use the same 
name for more than one file if the files are not in the same domain. 


TEMPORARY FILES PERMANENT FILES 


You may also use this name for a file that exists only between the 
time a program opens the file and closes it. If the system is search- 
ing for an existing file, it checks the Job Temporary File Directory 
before the System File Directory. 


SFILE.:.«NEWDEL | sFILE:«. .-NEWJTEMP -FILE... NEW;SAVE 


_ 





‘FILE... NEW 
-BUILD or :FILE is Used 


BEREREekhk He HaHRHHaeBHeaa a 


Program Opens Program 
File Opens File 
i 
- Program Closes 
i File 
Pa Current Session O 
- /Job Ends 
A -PURGE Used 
4 31 


You can list the names of temporary files by using the utility 
program, LISTEQ2* which is in the PUB group of the SYS account. 





SBUILD XTEMP: TEMP «em Create a temporary file named XTEMP. 
<FILE CUMACR=FILEONE; ACC=APPEND em Enter some :FILE commands. 
sFILE PRINTER; DEV=LP 

s<RUN LISTEQ@2@.PUB.SYS éem Initiate LISTEQ2 execution. 


LISTEQ@2 €C) COPYRIGHT HEWLETT-PACKARD COMPANY 1976. 

###TEMP FILES =m Names of temporary files are listed. 
XTEMP.GROUP1 .PAYACCT 

###F TLE EQUATIONS 


>-FILE CUMACR=FILEONE ;ACC=APPEND as LISTEQ2 also lists the :FILE commands in effect during the cur- 
*FILE PRINTERsDEV=LP rent session or job. 


If you want to clear the file characteristics assigned to a formal 
file designator, use the :RESET command. 





-RESET CUMACR Clears file characteristics assigned by previous :FILE command. 


You can reset or cancel all :Fl1LE commands previously entered in 
the session by entering 


sRESET © 


*LISTEO on pre-Series II systems. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
MPE System Utilities Reference Manual (Section V) 
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deleting a disc file 


If you no longer want to keep a disc file, you can delete it from 
your group and account by using the :PURGE command. 


sLISTF (em List files in log-on group. 

FILENAME 

CUSTOMER DATA3 EMPF ILE EMPLOYEE FILEONE FILETWO 
FILEXXX XFILE 

>PURGE DATA3 (== Delete DATA3 file from group. 

sLISTE List files again. 

FILENAME 

CUSTOMER EMP ILE EMPLOYEE F ELEONE FILETWO FILEXXxX 


XFILE 





The permanent file named DATA3 is deleted from the log-on You can delete a file from any group or account to which you have 
group. If you want to delete a temporary file, you must append a write (W) file access capability. 

comma and TEMP to the file name, for example, :PURGE FILEX, 

TEMP. If the file has a lockword you must supply it following the 

file name and a slash, :PURGE FILEX/PASS, TEMP. In session 

mode, MPE prompts for the lockword if it is not supplied. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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Changing the name of a disc file 


If you are the creator of a file, you can change its name. You must 
log on with the same user name and account that was used when 
the file was created. 


sHELLO MEMBER1 .PAYACCT Gza Log on to system with user name and account of file creator. 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 





-RENAME EMPLOYEE, EMP11 Somes Request to change name of EMPLOYEE file to EMP11. System 
ERR 120 prints error since MEMBER1 did not create the file named EM- 
CREATOR CONFLICT PLOYEE. 

“SRENAME EDITFILE, CUSTOMER a Request to change name of EDITFILE to CUSTOMER. Change is 
sLISTF successful since the file was created by MEMBER. 

FILENAME 

CUSTOMER EMPFILE EPIrPLOYEE FILEONE FILETEM FILETWO 

FILEXXX XFILE 

In order to change the name, you must be the creator and also have If the file to be renamed has a lockword assigned, you must pro- 
S (save) access to the group to which the file belongs and W (write) vide it with the name or when the system prompts for it. (See the 
access to the file. You can log on with the group name, use the next example.) 

group name to qualify the file name, or the group can be your < 


home group. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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assigning, changing, and removing a lockword 


The :RENAME command is also used to assign, change, or remove 
a disc file’s lockword. 





sRENAME CUSTOMER, CUSTOMER/LOCKA ™ Assign the lockword LOCKA to the CUSTOMER file. 


A lockword may be from 1 to 8 alphanumeric characters; the first 
character must be alphabetic. 





-RPEHAME FILEONE, FILEONE/REDROCK @=™ Assign lockword of REDROCK. If you try to remove the 
sRENAME FILEONE, FILEONE lockword, the system prompts for the current one. 

LOCKWORD: FILEONE.GROUP1.PAYACCT? 

REDROCK 

As you can see from this example, to remove a lockword, you re- To change the lockword, use the file name and a new lockword for 


name the file using its name and the current lockword as the first the second parameter. 
parameter and its name without the lockword for the second 
parameter. 





sRENAME CUSTOMER/LOCKA, CUSTOMER/KEY4LOCK fen Change CUSTOMER file’s lockword to KEY4LOCK. 





ADDITIONAL INFORMATION: 
MPE Commands Reference Manual (Section V1) 
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copying data from cards to a disc file 


To copy a file stored on punched cards to a disc file, you can use 
the FCOPY utility. 
a RP oO 


*HELLO MEMBER1.PAYACCT em Log on to the system. 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


Specify the characteristics of the disc file to be created. 


‘ILE. DISCFILE,NEWs REC=~80,3,F ,ASCII; SAVES DISC=200,¢e 
“FILE CARDS: REC=,,,ASCII; DEV=CARD Gama Define CARDS as a card reader device file with ASCII formatted 


*RUN FCOPY.PUB.SYS data. 
Initiate FCOPY execution. 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 

>FROM=#*CARDS; TO=*DISCFILE === Copy from the file named CARDS to the file named DISCFILE. 

EOF FOUND IN FROMFILE AFTER RECORD 27 Use asterisks to indicate a :FILE command has been entered to 
define these files. 

28 RECORDS PROCESSED ##%# Q ERRORS 

-EXIT =m After cards are copied, terminate FCOPY. 


END OF PROGRAM 





| The cards that you copy should be preceded by a :DATA com- 


mand card and followed by an :EOD card. 


:EOD The format of the :DATA command is: 


:DATA [jobname, |username [/upass] .acctname | /apass] [ ;filename] 


(Parameters enclosed in brackets are optional.) 


DATA TO BE COPIED TO FIRST RECORD 
The username and acctname parameters must exactly match the 


-:DATA MEMBER1.PAYACCT; CARDS log-on username and account name used in the :HELLO or :JOB 
command. If you include a filename, you must access the file with 
that same name. If you don’t specify a name you will access the 
first spooled file belonging to your username and account. 


username 
account name 


actual file designator 
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After you place the cards in the card reader hopper and turn the 
power on, press the RESET button. If the card reader is a spooled 
device, the cards are read in immediately and written to a special 
disc file until FCOPY accesses the CARDS file. If the card reader 
is not a spooled device, the :DATA command card is read but the 
rest of the cards remain in the hopper until the FCOPY program 
accesses the CARDS file. 


You can prepare the card reader and read the :DATA card either 
before or after you initiate your session. The :DATA command 
card simplifies card reader operations since the console operator 
does not have to intervene and allocate a device with device class 
CARD. 


The disc file is a new file named DISCFILE with the following 
characteristics: 


@ 80 character records 
® 3 records per block 
REC=-80,3,F,ASCII; 
@® fixed length records 
@ ASCII format 
© permanent file \ SAVE; 
@ maximum of 200 records 
‘ DISC=200,2 


2 extents 
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The system supervisor defines the device class for the card reader 
when the system is configured. In this example, CARD is the 
device class name. 


The format for a card reader device file is BINARY by default. 
If you include the REC=,,,ASCII parameter in the :FILE com- 
mand, you can avoid getting this warning message: 


>FROM = « CARDS; TO = « DISCFILE 

*201*; 

WARNING: FROMFILE IS BINARY, TOFILE IS ASCII 
CONTINUE OPERATION (Y OR N) ?Y 


If you do get the message, respond with a ““Y” and the data will be 
copied successfully. 


File names preceded by an asterisk back-reference a :FILE com- 
mand. In other words, the asterisk tells the system to use the 
information from a :FILE command that has been entered earlier 
in the session or job with the same formal file designator that fol- 
lows the asterisk. If no :FILE command is found, an error occurs. 
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Another method for copying card data to a disc file uses the NEW 
parameter of the FCOPY program. 


sFILE CARDS; REC=,,,ASCII; DEV=CARD 
SKRUN FLUPY.PUR.SYS 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 


>FROM=#*CARDS; TO=DISCF; NEW 
EOF FOUND IN FROMFILE AFTER RECORD 8 


9 RECORDS PROCESSED ### Q ERRORS 





RBPEBRBREEREHRHRHWHOHRHHHRHEeeae#saa 
— 


Since the card reader has undefined length records, the disc file will If you use this method the new file is created with 1023 records 

also have undefined length records if you use this method. FCOPY and, therefore, the maximum number of cards that can be copied is 

creates the TO-file with the FROM-file characteristics unless you 1023. If you want to copy more than 1023 cards, you should cre- 

use a :FILE command to define characteristics for the TO-file. ate a file with the :BUILD command first and then copy the cards 
to that file. 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 
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copying data from tape to a disc file 
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a“ 


To copy a magnetic tape file to a disc file, use the FCOPY utility. 


sBUILD FILEXYZ/LYXZ; DISC=500,4; REC=-90,3,F,ASCI1 = Create disc file. 
sFILE TAPFILE; DEV=TAPE; REC= ~B5,, sF sAStli Gm Specify device type for TAPFILE. 
eRUN FCOPY.PUB.SYS _|70 =m Initiate FCOPY execution. 
HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 
>FROM=*TAPFILE; TO=FILEXYZ/LYXZ; SUBSET Gaza Tell FCOPY to copy one file from the magnetic tape device 
EDF FOUND IN FROMFILE AFTER RECORD 27 referenced by TAPFILE to the disc file FILEXYZ with 
lockword LYXZ. 
28 RECORDS PROCESSED ### Q ERRORS 
>EXIT 
END OF PROGRAM 
SS Sa aa AE 
In this example, FILEXYZ is created before FCOPY is executed so The :FILE command that defines TAPFILE includes the REC 
that the disc file is bigger than the tape file and additional records parameter to specify that the tape records are 80 characters in 
can be added later. When using a :BUILD or :FILE command in- length and the data is in ASCII format. If the parameter group is 
stead of the FCOPY ;NEW option, you can specify other file not included, you will be given two warnings by FCOPY. 
characteristics such as the number of extents. 
#2002; = Reply with printable character. ‘ 
WARNING: FROMFILE RECSIZE IS 128 WORDS, TOFILE RECSIZE IS 80 BYTES. 
CONTINUE OPERATION CY OR N) ?Y = FCoPy prints warning. Reply with ““Y.” 
#eQ01al <== Reply with printable character. 
DKIARNING: FROMFILE IS BINARY, TOFILE IS ASCII 
CONTINUE OPERATION CY OR NWN) 7Y faa Reply with ‘‘Y” to continue. 


SL EI SE ESRC ET Fs Ee Se De Ee ee ee eS ATS ae 


These warnings appear because you have defined a record size of When copying from a tape, you must specify SUBSET to indicate 
80 characters for the disc file and specified that it is to contain that you only want to copy to the first end-of-file mark. If you do 
ASCII data. The FROM-file records are truncated in this case. If not include this parameter, FCOPY stops when a parity error oc- 
the FROM-file records are shorter than the TO-file records, the curs due to the end of all data on the tape. 

contents of the extra character positions are unpredictable. 





If the file has a lockword, as it does in the example, you can either 
supply a slash and the lockword following the file name or MPE 
will prompt for the lockword. For example: 


LOCKWORD: FILEXYZ.GROUP1.PAYACCT ? 


When FCOPY opens the tape file, a message is printed on the sys- 
tem console: 


device class name 


?10/10:27/#81062/42/LDEV# FOR “TAPFILE’ ON TAPE (NUM) 


time / formal file designator 
session 


number ' process identification number (PIN) 


To respond to this message, press the control key and A simultane- 
ously. The system responds with an equals (=) sign. Enter the fol- 
lowing response: 


=REPLY oN 
logical device on which tape is mounted (device 7 in this example) 


process 
identification number (PIN) 


FCOPY then copies the tape and rewinds it when it closes the tape 
file. 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 
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copying data from a disc file to the line printer or a terminal 


The FCOPY utility can also be used to copy data from a disc file to 
the line printer or to your terminal. 





FILE PRINTER: DEV"LF <= Define a devicefile named PRINTER with device class LP (line 
>RUN FCOPY.PUB.SYS printer). 

Ga Initiate FCOPY execution. 
HP32212A.1.03 FILE COPIER (CC) HEWLETT-PACKARD CO. 1976 

Ago? Specify FILEXYZ with lockword LYXZ as the FROM-file and 
>FROM =FILEXYZ/LYXZ; TO=#PRINTER back-reference the PRINTER file :FILE command. 
#200% Gas Press return to ignore warning. 
EOF FOUND IN FROMFILE AFTER RECORD 9 


170 RECORDS PROCESSED #224 Q ERRORS €™= 10 records are copied to the line printer. 





The line printer output looks like this: 


52/-58-31101BOWERS SUSAN A 13 DAKWOOD DRIVE SC FSHF 400 1 OYVY 
678-99-33444PARK RICHARD R 1290 FRIAR WAY CU MSHF 400 1 ie a 
789-23-5102305SGU0D JOSEPH K 4567 CALIF. ST. MY MSHF 450 3 OYY 
4$32-11-92012HOUGHTON MARGE S 313 MOONBEAM WAY LA FSHF 450 1 ONY 
275-86=38275SPIEGLE ROSALIE I 2e N. SRD STREET SJ FSSF35000 0 /50YY 
138-66-09021RICHARDS NORMAN A 1961 MULBERRY DR.LG MMSF35000 4 ONY 
499-73-8e47e2PIERCE EMMA R 460 SARATOGA AVE.SCLFMSF20000 e2 oY y 
253-48-00033PAPADAKIS JAMES L 1347 KINGSWORTH CU MMSF20000 3 OYY 
537-58-234S54MAC LEAN VINCENT T 819 PALO ALTO ST.MV MMSF15000 S OYY 
333-44-8282SKONIGSBERG JOANNE M 45 ELDEN STREET LA FMSF15000 e2 ONY 
If the records are longer than 132 characters, you must include the If you are copying a disc file to the line printer in job mode, you 
CHAR parameter or the entire record will not be copied to the line do not need to use the :FILE command or a TO-file. This is be- 
printer. In this case, you should also use the NORECNUM param- cause the default TO-file is $STDLIST and, in job mode, $STD- 


eter to suppress the file identification, record numbers, and word LIST is the line printer. 
offset numbers. 


- 


393 5 


gaa 


1 
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In the next example, the first 5 records are copied to the terminal 


from the disc file EMPLOYEE. 


>FROM=EMPLOYEE; TO=; SUBSET=0:4 


#2002; 


Omit the TO-file to send output to your terminal. 
Use the SUBSET parameter. 


WARNING: FROMFILE RECSIZE IS 108 BYTES, TOFILE RECSIZE 


CONTINUE OPERATION CY OR ND ?Y 


678-99-33444PARK RICHARD R 
039-23-51023S0S600D JOSEPH K 
432-11-93201 2HOUGHTON MARGE §S 

2/S-36-s927SSPIEGLE ROSALIE I 
138-66-09021RICHARDS NORMAN A 


S RECORDS PROCESSED ##2# Q ERRDRS 
>EXIT 


END OF PROGRAM 





The TO-file is assumed to be the standard job or session list device, 
$STDLIST, if you do not specify a file name for it. $STDLIST is 


1290 FRIAR WAY CU 
4567 CALIF. ST. MV 
313 MOONBEAM WAY LA 
fe Ns SRD STREET SJ 
1961 MULBERRY DR.LG 


your terminal if you are operating in session mode. The record size 
for a terminal is 80 bytes (characters) by default. FCOPY warns 


you that the FROM-file and the TO-file are not the same size. * 
You can ignore the warning by entering a ““Y” in response to the 
prompt that follows the warning message (or pressing carriage re- 


turn when *200” is displayed). 


Manual. 


“If you want to have the warning message printed, enter any print- 
ing character except a colon (:). To skip printing the message, 


press the carriage return. 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 
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IS 30 BYTES. 

MSHF 400 1 OYY 
MSHF 450 3 OYY 
FSHF 450 1 ONY 
FSsF 320000 0 7S0yyx 
MMSF35000 4 ONY 


SUBSET =starting-record-number : 


or 


You may specify a subset of the file as 


last-record-number 


SUBSET =starting-record-number , number-of-records 


as well as several other ways described in the FCOPY Reference 


printing information on the line printer 


Many MPE commands allow you to specify where the command's printer as a devicefile by using the :FILE command and then use 
output is to be printed. The parameter you use to specify this is the back-reference form of the file name as the //stfi/e parameter. 
usually called the //stfi/e parameter. To use the line printer as the For example, to list information about files on the line printer: 
listfile when you are operating in session mode, define the line 

Eee TT a RT 


sHELLO MEMBER1 .PAYACCT <=™ Log on to system. 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


jem Define a file, in this case named LP, with device class LP (line 
‘FILE LPsDEV=LP printer). Use the file name preceded by an asterisk (*) as the /istfile 
*«LISTFE @.GROUP2 ,2; #LP parameter. 
SL 


In this example, the @ symbol and group name are used with the tion to be listed. Here is an example of the information as it is 
LISTF command to request information about all the files in displayed on the line printer: 
GROUP2. The second parameter, 2, specifies the type of informa- 


ACCOUNT= PAYACCT GROUP= GROUP2 

FILERAME CODE <—9o--°C-"--- LUGLCAL KECORD-——— --—------ == SPA Eom AOE 
ot ad Se i 4 EOF LIMIT R/B SECTORS #X MX 

DLOCr LLE 80B FA 28 200 3 S4¢ 1 2 729 

DISCFL 80B FA 20 1023 2 43 1 8 77? 

FILEX 80B FA 20 40 S is 1.4 Fa 

PALES YZ 80B FA 28 500 3 42 #1 4 72? 


a 


PREPFRPFRFRP RP PPP AAAs 




















{ 


J 
J 
J 
4 
7) 
A 





The file name you use to define the devicefile is arbitrary as long 
as it is 8 alphanumeric characters or less, beginning with an alpha- 
betic character. For example, you can use the names PRINTER, L, 
LINEPRINTER, PR, or X. 


If the line printer is a spooled device, you may want to specify the 
output priority for the listing and the number of copies to be made. 
For example: 


‘FILE PRINTER; DEV=LP,13,4-~——— numcopies 


outputpriority 


specifies that the listing is to have the highest priority and that four 
copies are to be made. 


This form of the :FILE command is often used in production jobs 
to specify the number of copies of a report to be printed. The 
name of the output file in the program can be used directly 


:-FILE OUT; DEV=LP,13,4 
or it can be equated to a different device file name. 
‘FILE OUT=PRINTER; DEV=LP,13,4 


J 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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The FCOPY utility program can be used to combine two or more 


files by using an asterisk (“) as the TO-file name. 

SSS IG SL NS BEY AE TOR ESERIES To aR | 
sFILE MAGTAPE; DEV=TAPE; REC=-80,9,F,ASCII Guan Specify file MAGTAPE as a magnetic tape with 80 
sRUN FCOPY.PUB.SYS character records, 9 records per block. 
HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 

>FROM = EMP1; TO = #MAGTAPE == Copy from disc file EMP1 to the beginning of the tape. (Asterisk 
EDF FOUND IN FROMFILE AFTER RECORD 9 back-references the :FILE command). 


10 RECORDS PROCESSED ### 0 ERRORS 


= Copy from EMP2 disc file to the tape beginning at the current 
position following the EMP1 data. (Asterisk indicates copy from 
current output tape position.) 


>FROM=EMPe2; TO=* 
EDF FOUND IN FROMFILE AFTER RECORD 9 


10 RECORDS PROCESSED ### Q ERRORS 
>FROM=EMPLOYEE; TO=% (== Copy from EMPLOYEE disc file to the tape beginning at the cur- 
EOF FOUND IN FROMFILE AFTER RECORD 19 rent position following the EMP2 data. 
20 RECORDS PROCESSED ### Q ERRORS 
a >EXIT = Terminate FCOPY program. 


END OF PROGRAM 
eA LIAR TS 


Only one end-of-file mark is written to the output tape and it 
follows the last record copied. 


BERBER EHBAOHRHOHRHEBEHEBRHEBeaaa ea 
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When FCOPY opens the tape file, a message is printed on the sys- 
tem console: . 


210/12:20/#81061/29/LDEV# FOR “MAGTAPE” ON TAPE (NUM) 


=REPLY 29,8 


process identification 
number 


Control A causes MPE to print = sign 


FCOPY prints a warning if the records of the TO-file are not the 
same size as the records of the FROM-file. If you indicate you 
want to continue running FCOPY, the records are copied. (See 
“Copying Data from Tape to a Disc File’’ in this manual for 
details). 


If instead of using an asterisk you repeat the TO-file name in an 
FCOPY command following the first one, the TO-file is rewound 
and the tape device is set to an offline (or ‘“‘not ready’’) state. For 
example, if the second FCOPY command in the example above is 
changed to 


>FROM=EMP2; TO=*MAGTAPE 


the tape rewinds and the tape device is no longer in a ready state. 


The system prints a message such as this on the system console: » 


10/12:21/LDEV#8 NOT READY 
You must then begin again by copying the first file to the tape. 


You can also combine files by copying to another disc file using 
the :BUILD command to create a file large enough to contain the 
combined files and then using the same techniques as illustrated in 
this example to copy the files. 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 


Respond with Control A, REPLY, the process identification num- 
ber (29), and the logical device number of the tape device (8 in 
this example). 
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combining ASCII disc files with the editor 


if you want to combine files containing ASCii data, it may be 
easier to use the Editor than FCOPY. 
RRR gS A SS TET TW A 


>EDITOR == Initiate Editor execution. 


HP32201A.S5.01 EDIT/3000 FRI, JAN 21, 1977, 3:40 PM 
CC) HEWLETT-PACKARD CO. 1976 


/TEXT EMP1 ,UNN <== Move the contents of the EMP1 disc file into the work file. Then — 
/JOING@ EMP2,UNN move the contents of the EMP2 disc file into the work file follow- 
NUMBER OF LINES JOINED = 10 ing the EMP1 data. Save the combined files in a new file named 
/KEEP EMPALL,UNN EMPALL. 

FEAIT 

IF IT 18S OK TO CLEAR RESPOND “YES” 

CLEAR? Y 


END OF SUBSYSTEM 





The line or record length is established by the file specified in the ® The file data must be in ASCII format. 
TEXT command. If the records that are added with the JOIN com- © The JOIN command appends a file’s records to the WORK file 


mand are longer than the records that are already in the work file, unless instructed to insert them at a particular line number. If 


the records are truncated to the proper size. If the file that is added the JOIN file is unnumbered and you do not specify UNN, the 
with the JOIN command is shorter, the records are padded with last eight characters of each record will be discarded. 
blanks. 


Before using the TEXT command, you may want to use the Editor 
If you use the JOINO form of the JOIN command, as shown in this sey cj 7E= command to make the work file large enough to con- 


example, the records are not displayed on the terminal when they tain the combined files. Otherwise you may get the message 


are joined to the work file. SCRATCH FILE IS FULL. KEEP, THEN TEXT AGAIN. Save the 


: current work file contents and then TEXT the saved file in again. 
Here are some important things to remember about the file to be 


joined to the work file: 


@ Only disc files can be joined to a work file. If you want to join ADDITIONAL INFORMATION: 
iF gag you must first use FCOPY to copy the tape file to EDIT/3000 Reference Manual 


@® The file code must be a number between O and 1023. In most 
cases, it will be the system default of 0. You can use LISTF to 
see what the file code is. 
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copying a subset of a file to another file 


a | 


i 
1 


In this example, all hourly employees in the EMPLOYEE file are 











FCOPY warns that the line printer records are longer than the 
EMPLOYEE records. Reply with a Y to ignore the warning. 


EOF FOUND IN FROMFILE AFTER RECORD 19 
3 RECORDS PROCESSED ### Q ERRORS 


PDEXIT 
Ls Stan SuPOT Sal la ae Beni a RATA acim TO cae betta Ea NS ISS ga ic Stn es aN ale A Na se 22a Oe a ie a Tee eee aaanies relia as 2 MLSE ZC AG AS at Re MMT FL STE Ge NB Seta Mee oy 
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selected and copied to a new file named HOURLY that is created r 
by FCOPY. . 
r 
-RUN FCOPY.PUB.SYS <= Initiate FCOPY execution. [ 
HP32212A.1.03 FILE COPIER CC) HEWLETT-PACKARD CO. 1976 [ 
>FROM=EMPLOYEE; TO = HOURLY; NEW; SUBSET="H",58 <== Copy all EMPLOYEE records with an “H” in 
EDF FOUND IN FROMFILE AFTER RECORD 19 character position 58 to a new disc file named { 
HOURLY. 
9 RECORDS PROCESSED *#* 0 ERRORS [ 
>EXIT [ 
END OF PROGRAM [ 
Nine records are located and copied to the HOURLY file. [ 
If you want to copy the records of all employees who live in Santa L 
Clara to the line printer, use a :FILE command to define the TO- 
file. ( 
sFILE PRINTER; DEV=LP == Define PRINTER as a devicefile with device class LP and initiate f . 
sRUN FCOPY.PUB.SYS FCOPY execution. | [ 
HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 " 
>FROM=EMPLOYEE; TO=*PRINTER; SUBSET="SCL"™,53 eae] Copy from EMPLOYEE file to line printer all rec- 
#?oge ords with SCL beginning in character position 53. e 
WARNING: FROMFILE RECSIZE IS 80 BYTES, TOFILE RECSIZE IS 132 BYTES. 
CONTINUE OPERATION CY OR WN) ?Y . {. 
L. 
6. 
L. 


The asterisk preceding PRINTER indicates that PRINTER has been 
defined with a :FILE command. 





The line printer listing looks like this: 





499-73-82472PIERCE EMMA R 460 SARATOGA AVE.SCLFMSF20000 2 OYY 
456-97-00543GDMEZ ROBERT D 1331 POETT LANE SCLMMSF27000 2 0YY 
300-24-36664JUNG DIANA T 965 WINCHESTER SCLFMHP 850 2 OYY 

















ADDITIONAL INFORMATION: 
FCOPY Reference Manual 
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copying a disc file from one group to another 


You can copy a file from a group to which you have R (read) ac- ACCT account has read access to the files in this group. If MEM- 
cess to another group to which you have S (save) access by qualify- BERA whose home group is GROUP2 wants to copy a file from 
ing the FROM-file name with its group name. Suppose the account GROUPX to GROUPA, he does it as shown in the following 
manager creates a group named GROUPX with these file access example. 

capabilities: (R:AC; A,W,L,X,S:GU). Every member of the PAY- 


ES STE TSE 
sHELLO MEMBERA.PAYACCT (== MEMBERA logs on to PAYACCT and his home group GROUP2. 


:RUN FCOPY.PUB.SYS (== MEMBER initiates FCOPY. 
HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 


>FROM=XFILEX.GROUPX: TO=XFILEX:; NEW (=a Copy XFILEX from GROUPX to a new file in GROUP2 named 
EOF FOUND IN FROMFILE AFTER RECORD 27 XFILEX. 


©8 RECORDS PROCESSED #+#2# OQ ERRORS (e=a Note that although this message is printed, the new file is not actu- 
ally saved until FCOPY closes the file and terminates. 


EXIT 
EE ee ee ee ee ee Oe een a a on a ne roe ee een nn ae on ees 


If you need to copy a file to your group from a group to which rect user name, account and group. The creator may log on to a 
you do not have R (read) access, you can do so provided the cre- group that does not contain the file and release its security provi- 
ator of the file releases the file’s security provisions. Only the cre- sions by qualifying the file name with the name of the group to 
ator can do this. He identifies himself by logging on with the cor- which the file belongs, for example, DISCFILE.GROUP1. 
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BEE RABE REBAHKRHEEHB BHR HEeaBeaea Bo 


SSS SS aS a 
>HELLO MEMBER1.PAYACCT = File creator logs on to PAYACCT (home group is GROUP'1). 


HP3000 / MPE IIT B.00.00. TUES, MAY 16, 1978, 2:00 PM 


sRELEASE DISCFILE = Creator releases the security for DISCFILE. MEMBERA whose 
sHELLO MEMBERA.PAYACCT home group is GROUP2 logs on to PAYACCT. 


ig End of MEMBER1’s session message is displayed. 
CPU=1. CONNECT=1. MON, JAN 9, 1978, S:24 PM 
HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


Cane Beginning of MEMBERA’‘s session message is displayed. 


-RUN FCOPY.PUB.SYS (=== MEMBERA initiates FCOPY. 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 


D2 FRom-DIScrILE GROUP! >; TO=FILEX; NEW <== Copy DISCFILE from GROUP1 to a new file named FILEX and 


EOF FOUND IN FROMFILE AFTER RECORD 27 save it in log-on group, GROUP2. 


28 RECORDS PROCESSED ### Q ERRORS 


P>EXIT 
END OF PROGRAM 4m If the files in GROUP2 are listed, the new file FILEX is in the 
cLiSre group. 
FILENAME 
FILEX 
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>HELLO MEMBER1.PAYACCT q==n Creator logs on again. 


(End of session and beginning of session messages are displayed.) 


>SECURE DISCFILE Gaza Creator reinstates DISCFILE’s security provisions. 





The file’s security provisions need not be released if you log on to 
the group containing the file. To do so you must Know the group 
name and its password, if one is assigned. 


SHELLD MEMBERA.PAYACCT,GROUP' (=== MEMBERA logs on to PAYACCT group GROUP1. 


*<RUN FCOPY.PUB.SYS (== Initiate FCOPY. 


HP32212A.1.03 FILE COPIER CC) HEWLETT-PACKARD CO. 1976 


>FROM=DISCFILE; TO=FILEX _GROUP2: NEW <= Copy DISCFILE from GROUP1 to a new file named FILEX in 
EOF FOUND IN FROMFILE AFTER RECORD 193 GROUP2. 


e€0 RECORDS PROCESSED ### Q ERRORS 


PEXIT 
END OF PROGRAM 


In this example, MEMBERA logs on to GROUP1 and can copy a 
file from GROUP1 to his home group, GROUP2. 


- 


FPFRPP PRP RFF RF RFR RP AAA Ass 


Daa 


SaaS SS SESH AREAS 


In the next example, MEMBER1 attempts to copy a file to 
GROUP2 when logged on to his home group, GROUP1. 
ER eae RE Re eS ee RS 


-HELLO MEMBER1 .PAYACCT (= MEMBER? logs on to PAYACCT with home group GROUP. 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


“RUN FCOPY.PUB..SYS 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 


>FROM=FILEXYZ/LYXZ; TO=FILEXYZ.GROUP2;NEW Gam Copy FILEXYZ from GROUP‘1 to a new file with the 


EOF FOUND IN FROMFILE AFTER RECORD 27 same name in GROUP2. 

28 RECORDS PROCESSED ### OQ ERRORS ¢a Copy complete but FCOPY does not save new file until 
program is terminated. 

yEXIT =a Terminate FCOPY. 

2104¢eL =a When FCOPY tries to create the new file it discovers that only 

CAN’T SAVE NEW TOFILE group users can create files in GROUP2. The copy fails. 


DISPLAY FILE INFORMATION CY OR N) 2?N Gam A response of N inhibits the printing of a file information display 
(FID) explaining error. 


The results of this operation depend on the way GROUP2 is de- 
fined by the account manager. In this case, the group is defined so 
that only group users (GU) have save (S) access to the group. 
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If MEMBER1 logs on to GROUP2, he can successfully copy the 
file. Since GROUP1 is MEMBER1’s home group, he need not 
release the security provisions. 


FSS A ERT Er ES TT 
sHELLO MEMBER1.PAYACCT ,GROUP2 <== MEMBER1 logs on to PAYACCT group GROUP2. 


:-RUN FCOPY.PUB.SYS 
HP32212A.1.03 FILE COPIER CC) HEWLETT-PACKARD CO. 1976 


>FROM=FILEXYZ.GROUP1; TO=FILEXYZ;NEW <== Copy FILEXYZ from GROUP1 to a new file of the same name in 
LOCKWORD: FILEXYZ.GROUP1.PAYACCT? GROUP2, the log-on group. 


EDF FOUND IN FROMFILE AFTER RECORD 27 Since the file has a lockword, FCOPY requires that it be supplied. 


e8 RECORDS PROCESSED ### Q ERRORS 


PEXIT 

Esc oe ce cc uence nu eae on mtu eer umn ny Ou OD Dn ena ee eee ee eG emery 
In summary, when copying files from one group to another you If you log on to your home group you may be able to save files in 
must be aware of: that group only. If you log on to another group, and the groups ar 
6 who created the file defined with the system defaults for file access capability, you can 


= save files in both your home group and your log on group. 
@ what type of file access is defined for the group containing the 


file and the group to which the file is to be copied 


@ what groups you have access to when you log on. 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 
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transferring a disc file from one group to another 


To transfer a file from one group to another, use the :RENAME 
command. You must be the creator of the file in order to do this. 
EB faa RE PR ae aT HR RT ABE A 7 A es ree oe 


sHELLOD MEMBER1.PAYACCT ,GROUP2 Sas Creator of file logs on to group to which file is to be moved. 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


-RENAME DISCFILE.GROUP1, DISCFILE = DISCFILE is moved from GROUP'1 to log-on group, GROUP2. 
SLISTe 3 





FILENAME 
DISCFILE FILEX 4 DISCFILE is now in GROUP2 in the system directory. 
You must have SAVE access to the group to which the file is to be GROUP1 GROUP2 
transferred. Assuming GROUP2 was defined with the system oe CUSTOMER __ _-» DISCFILE 
fault file access capability, only group users (GU) may save files in _ —:RENAME 
the group. Since MEMBER 1's home group is GROUP1, he must log DISOK(LE FILEX 
on to GROUP2 in order to save a file in that group. EMPFILE FILEAYZ 
FILEONE 
Note that the file named DISCFILE is no longer in GROUP1 after 
FILETWO 


the :RENAME command is executed. The file is transferred rather 


) than copied. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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copying a disc file from one account to another 


In order to copy a file from one account to another, the file’s cre- the file (unless the account allows R (read) access to ANY system 

ator must agree to temporarily release the security provisions for user). 

ee a rn 

eHELLO MEMBER1.PAYACCT @m File creator logs on to PAYACCT and home group, GROUP, that 
contains file. 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


-RELEASE DISCFILE == Creator releases DISCFILE’s security provisions. 
eHELLO USERA.PERSONL eas User who wants to copy file to another account logs on to that 
account. 


bs End of MEMBER 1’s session. 


CPU=1. CONNECT=3. MON, JAN 9, 1978, 5:00 PM 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 
ey Beginning of USERA‘’s session. 


-RUN FCOPY.PUB.SYS <== Initiate FCOPY execution. 


HP32212A.1.03 FILE COPIER CC) HEWLETT-PACKARD CO. 1976 


>FROM=DISCFILE.GROUP1.PAYACCT; TO=FILEX; NEW ca Copy DISCFILE from GROUP1 of PAYACCT to 


EDF FOUND IN FROMFILE AFTER RECORD 27 a new file named FILEX to be created and saved 
in USERA’s home group of the PERSONL ac- 

28 RECORDS PROCESSED ##%# Q ERRORS count. 

>EXIT Gam FILEX is saved when FCOPY closes the file. 


END OF PROGRAM 


eHELLD MEMBER1.PAYACCT (a File creator logs on again. 


“= 


a | 


“~ 


a a 


n 


ee ee en ee ee ee ee ee ee oe ee ee oe oe oe oe oe 


(End of session and beginning of session messages are displayed.) 


sSECURE DISCFILE axa Creator reinstates file’s security provisions. 





If you want to move a file rather than duplicate it in another ac- 
count, the creator can use the :PURGE command and delete the 
file from the account in which it was originally created instead of 
using the :SECURE command. 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 
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copying an EBCDIC file to an ASCII disc file 


If you have a tape file containing EBCDIC data, you can copy it to 
a disc file and translate the data to ASCII format at the same time 
by using FCOPY. 


REC=-80 ,3,F ,ASCII ; 





SF LLE DISCK ILE HEM; SAVE; DISC=#2000,4 


-FILE TFILE; DEV=TAPE; REC=-80,10,F,ASCII <= Specify a tape file named TFILE with 80 character 
<RUN FCOPY.PUB.S7S records, 10 per block. ASCII indicates non-binary in 


this case. 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 


>FROM=#TFILE; TO=*DISCFL; SUBSET; EBCDICIN =a Copy from the TFILE device to disc file named 


FOF FOUND IN FROMFILE AFTER RECORD 19 DISCFL. Stop at the first end-of-file mark. The 
input data is in EBCDIC format. 


20 RECORDS PROCESSED ### Q ERRORS 


>EXIT 

END OF PROGRAM 

“<LI6TF DISCFL<2 4m :LISTF displays the characteristics of the new file. 

ACCOUNT= PAYACCT GRODUP= GROUP1 

FILENAME CODE ------------ LOGICAL RECORD----------- ----SPACE---- ACC 
SiZE TYP EOF LIMIT R/B SECTORS #X MX 

DISCFL 80B FA 20 1022 3 4S 1 8 FF? 


ASCII format 





If you do not create the disc file with a :BUILD or :FILE... ,NEW If the tape you are copying has a label and you do not want to 


command, the disc file will contain at most 1023 records by de- copy it, you can skip it by specifying: 
Fault. >FROM=*TFILE; TO =*DISCFL; SUBSET; EBCDICIN; 
SKIPEOF=1 


The EBCDICIN parameter instructs FCOPY to translate the 


EBCDIC data to ASCII format. The SKIPEOF=1 parameter tells FCOPY to skip past the first end- 


of-file mark before copying any information. 
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If the input tape contains fields written in packed decimal format, 
you use FCOPY. Alternatively, you can write an application pro- 
gram that uses the system intrinsic CTRANSLATE to translate the 
EBCDIC fields and leave the packed decimal fields unchanged. 


If you do not include the REC= parameters in the :FILE command 
for the tape file and you try to copy to a file that does not have 


128 word records, FCOPY prints a warning. It prints another warn- 
ing if you do not specify ASCII data and you try to copy to a file 
defined with ASCII formatted data. These warnings are printed 
because the FCOPY default record length for a tape file is 128 
words and the default data format is BINARY. 


‘BUILD DISCK: REC=--S0 ,3,F .ASUIL ; 
SFILE TFILES DEV=TAPE 
sRUA FCOPY.PUB.SYS 


HP32212A.1.03 FILE COPIER CC) HEWLETT-PACKARD CO. 


>9FROM=*TFILE; TO=DISCF; SUBSET; 


DISsC=500,e 


ens Create disc file named DISCF. 
== Define TFILE. Omit REC= parameters. 


1976 


EBCDICIN=(C1,5;6:10;21:30) 


@eme_ Copy from TFILE to DISCF. 


See “Copying Data from Tape to a Disc File’ in this manual for 


more information about FCOPY warning messages. 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 


copying an ASCII file to an EBCDIC file 


FCOPY can create files containing EBCDIC formatted data. 





sFILE TFILE; DEV=TAPE; REC=-80,10,F ,ASCII <emm Define a tape file named TFILE with 80 character rec- 


:RUN FCOPY.PUB.SYS 


ords in blocks of 10 containing ASCII (non-binary data). 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 


FROM=EMPLOYEE; TO=#TFILE; EBCDICOUT <=™ Copy from a disc file named EMPLOYEE containing ASCII data to 


EOF FOUND IN FROMFILE AFTER RECORD 19 
20 RECORDS PROCESSED ### Q ERRORS 
>DEXIT 


END OF PROGRAM 


the TFILE tape file, translating the data to EBCDIC format. 





The EBCDICOUT parameter instructs FCOPY to translate the 
ASCII characters to EBCDIC format. 


If the ASCII disc file contains packed decimal data, FCOPY does 
not copy the data correctly. Therefore, you should avoid using 
packed decimal data fields in a file that is to be translated to 
EBCDIC format with FCOPY. These data fields should be written 
in ASCII format and converted to packed decimal data format on 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
MPE Commands Reference Manual (Section V1) 


the system to which the EBCDIC data is being transferred. (You 
can copy the tape with a program of your own that uses the 
CTRANSLATE intrinsic). 

FCOPY also translates ASCII data to BCD (Binary coded decimal) 
format for systems requiring data in that format. In this case you 
specify BCDOUT. 


Daas 
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sorting data 


The SORT program may be run as a stand-alone program during 

either a session or a job. In this example, it is run from a terminal 

during a session. 

ES A Ge TT SS Sg So TE ated 

>RUN SORT.PUB.SYS == Initiate SORT execution. SORT is in the PUB group of the SYS 
account. 


HP32214B.01.02 SORT/3000 FRI, JAN 21, 1977, 10:59 AM 


€C) HEWLETT-PACKARD COD. 1976 
; eon SORT prompts for commands with greater than (>) symbol. 


> INPUT EMPLOYEE e=a Specify EMPLOYEE as the input file and SORTEMPL as the out- 
>OUTPUT SORTEMPL put file. 

>KEY S8,1 = Specify the major sort key field by indicating the first character 
>KEY 13,12 and length of the field. Then specify the second level sort key. 
>VERIFY f=: The VERIFY command requests a summary of the SORT options 


which are in effect. 
INPUT FILE = EMPLOYEE 


BUTPUT FIEE = SORTEMPL 


KEY POSITION LENGTH TYPE ASC/DESC 
S8 1 BYTE ASC CMAJOR KEY) 
13 iz BYTE ee 

| ascending sequence 

>END 
STATISTICS (om A summary of statistics about the sort is printed after the sort is 
completed. 

NUMBER OF RECORDS = 2 
RECORD SIZE CIM BYTES? = 108 
NUMBER OF INTERMEDIATE PASSES = 0 
SPACE AVAILABLE CIN WORDS) = t3a,<2R1 
NUMBER OF COMPARES = 89 
NUMBER OF SCRATCHFILE I[0°S = 18 
CPO FIME CMIAUTES) = 207 
ELAPSED TIME CMINUTES) = 04 


END OF PROGRAM 
Nee TT 
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When you specify a key, you can define the type of data to be Refer to the example on the preceding page. Records of the 


sorted and the sequence in which it is to be sorted. For example: EMPLOYEE disc file are sorted according to the information in 
>KEY 58,1,BYTE,ASC the 1-character field in character position 58. 
type sequence ie second level a sorting is based on 12 characters beginning 
with character position 13. 
If these parameters are omitted, as they are in the example, the de- — The sorted data is written to a new disc file created by SORT and 
faults are BYTE (character) and ASC (ascending sequence). saved with the name SORTEMPL. The characteristics of the new 


file are the same as the characteristics of the input file EMPLOYEE. 
BYTE type keys are sorted byte by byte according to the value of 





the 8 bits in each byte. If the data is ASCII it will be in ASCII Sorted records can be sent to the line printer device file. Note that 
collating sequence after the sort. If the data is EBCDIC, it willbe | the back reference indicator, the asterisk, is not required in this 
in EBCDIC collating sequence. case. 

SFILE LPs DEV=LP =m Define a device file named LP with device class LP and initiate 
-RUN SORT.PUB.SYS SORT execution. 


HP32214B.01.02 SORT/3000 FRI, JAN 21, 13977, 11507 AM 
CC) HEWLETT-PACKARD CO. 1976 


>INPUT EMPLOYEE = Specify the input file, EMPLOYEE. 
>OUTPUT LP =x Specify the output file, LP (the line printer). 
PREY 13:,12,DESC é== Specify the major sort key: 12 characters beginning in character 
>END position 13 to be sorted in descending sequence. 
STATISTICS 
NUMBER OF RECORDS = 20 
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Jas 





The sorted records are printed on the line printer: 





























322-11-35874YEE JANICE K 310 BEEKMAN PLACECU FSSF27000 0 0YY 
275-86-38275SPIEGLE ROSALIE I 2@2 N. 3RD STREET SJ FSSF35000 0 750YY 
S89-24-21124SCRUGGS RODNEY X 76 AUBURN DRIVE CU MMHP 800 1 OYY 
138-66-09021RICHARDS NORMAN A 1961 MULBERRY DR.LG MMSF35000 4 ONY 
342-48-83295POWELL PATRICIA J 249 FREMONT AVE. LA FMHF 1000 4 OYY 
499-73-82472PIERCE EMMA R 460 SARATOGA AVE.SCLFMSF20000 e OYY 
678-99-33444PARK RICHARD R 1290 FRIAR WAY CU MSHF 400 1 OYY 
253-48-00033PAPADAKIS JAMES L 1347 KINGSWORTH CU MMSF20000 3 OYY 
089-23-510230SGD00D JOSEPH K 4567 CALIF. ST. MV MSHF 450 3 0OYY 
466-39-443340R02C0 JOSEPH N 112 BRIGHTEN AVE.MV MMHP 800 e2 OYY 
537-58-23454MAC LEAN VINCENT T 819 PALO ALTO ST.MV MMSF15000 5S OYY 
= 333-44-8282SKDNIGSBERG JOANNE M 4S ELDEN STREET LA FMSF15000 e2 ONY 
.: 300-24-36664 JUNG DIANA T 965 WINCHESTER SCLFMHP 850 e2 OYY 
244-75-3844SJENSEN HILDA A 17650 SHADOW LANELG FMHF 1000 0 800YY 
432-11-92012HOUGHTON MARGE S&S 313 MOONBEAM WAY LA FSHF 450 1 ONY 
S31-66-77771HORN MICHAEL S 2230 BRONSON AVE.SJ MMSF2e0d0d 1 ONY 
456-97-00543GO0MEZ ROBERT D 1331 POETT LANE SCLMMSF27000 e OYY 
E 212-83-95432FERGUSON KATHERINE L729 UNION AVENUE LG FMSF22000 0 OYY 
= S27-58-31101 BOWERS SUSAN A 13 DAKWOOD DRIVE SC FSHF 400 1 OYY 
142-67-SS33S5ALEXANDER GEDFFREY N 702 CORVALLIS DR.SCRMSSF45000 O1000YN 


character position 13 


id You may also call SORT procedures from your programs. Read 
about this in the SORT/3000 Reference Manual. 


ADDITIONAL INFORMATION: 


SORT/3000 Reference Manual (Sections | and I!1) 
MPE Commands Reference Manual (Section V1) 
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oreparing a production job 


The easiest way to prepare job control commands is to enter them job stored in a disc file, you can use the :STREAM command as 
in a disc file using the Editor (although they may also be punched illustrated in the example following this one. 
in cards and read from the card reader). When you want to run a 





:EDITOR @*™ Initiate Editor execution. 


HPSe2cu1A.S.<01 EDIT/SS000 TUE, JAN 25, 1977, 1:09 PM 
CC) HEWLETT-PACKARD CO. 1976 


/ADD = Add new lines to the work file. 
1 (1)! JOB XX34,MEMBER1.PAYACCT ,GROUP1 The first record is the JOB command with exclamation point (!) 
e ‘COMMENT instead of colon (:). 
3 (2) CCUM), Seo ees eee ee § eee & ee ex reroeS Sacer ee Fee 
& 'COMMENT ACCOUNTS RECEIVABLE UPDATE 
5 TCOUMMER | =< 8 =< = Hee Se ee Se i ee ee 
6 'TELLOP PRERFSRPPRSRFFFRHR FSH FSP HRFRL FHF FSR HFHFRPPRRRRRRESE 
7 TELL. OP # JOB XX34 STARTING 
8 PTELLUP 2 i 
3 (3) 'TELLOP + ACCOUNTS RECEIVABLE UPDATE RUN - # 
10 'TELLOP # MOUNT “CHKRCVD’ TAPE AND STANDBY i 
11 !'TELLOP 2 tO REPLY 10 IT: a 
12 PTELLOP # = 
13 'TELLOP HRERFFFRRFRRSHFFPFRHPHRFRRSHFRFHFBPRRBSFRHRFRHFRRFRRRRRRHA 
14 ‘PURGE DCHKRD 
(Example continued on next page.) 
When preparing a job to be streamed, you must substitute another (3) The TELLOP command prints a message on the system con- 
character for the colon normally used with MPE commands. Any sole. In this example, the operator is notified that a job is 
ASCII charaéter may be used except the letters A through Z or the starting and told to mount a particular tape for the job. Thus, 
numbers 0 through 9. The character most commonly used is the if you initiate the job at a terminal, you can communicate 
exclamation point for reasons you will see in the STREAM exam- with the operator. 


ple which follows. 
(4) To ensure that a DCHKRD file can be created, the PURGE 


(1) The first command in a job must be the JOB command, fol- command is used to delete an old DCHKRD file if one exists. 
lowed by the user name, account name, and optionally the 
group name. In production work it is useful to specify a 
job name before the user name to identify the specific job 
that is being run. In the example, the job name is XX34. 


(2) By using COMMENT commands, you can describe the func- 
tion of the job within the job file. 
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/K ACRJOB,UNN 





15 (©! FILE IN; DEV=TAPE; REC=40,3,F,ASCII 





REC=-90:,3,F ,ASCLI 


= Define input file. 


SUBSET; SKIPEOF=1 


Enter FCOPY commands in job. 


(= Enter commands to prepare files and 


Grows Enter command to notify operator that job is finished. 


(=m Enter end of job command. 


16 "RUN FCOPY.PUB.SYS 

1% FROM=#IN; TO=DCHKRD; NEW; EBCDICIN; 
18 EXIT . 

19 ‘EDD 

20 'TELLOP #** JOBXX34 FCOPY COMPLETE ## 
2 1 (8) 'PURGE WORKFL 

Ce ‘BUILD WORKFL; DISC=1000; 

eo 'FILE NEWCHK=DCHKRD 

24 ‘FILE OUT=CUMACRC; ACC=APPEND 

2b 10" RUN ACRUPD 

26 IiTELLOP HSRPRHRSFHHFHRHRRFHSRRHRHRRRRR 

a7 PTELLDP *# JOB XX34 END & 

28 (2) ITELLOP HRERPFRRHRRSPFSRSHFRRRRRBRREH 

ab 'EOJ 

30 


(5) In this example, the IN file is defined as a tape device with 
40 word (or 80 character) records in ASCII format, three 
per block, and fixed length. 


(6) The first program to be run in the job is FCOPY. 


7) The FCOPY commands must be included since this is a job 


and not an interactive session. The FCOPY prompt character, 
>, is not included. FCOPY is instructed to skip to the first 
end-of-file mark (following an existing tape label), translate 
EBCDIC data on the tape to ASCII data, and copy it to a 
new disc file named DCHKRD. After this operation is finish- 
ed, FCOPY is to terminate. The EOD command ensures that 
the program cannot read beyond this point even if something 
goes wrong. The TELLOP command notifies the console 
operator that the tape copy is complete. 


A file named WORKFL is used each time the job is run. The 


PURGE command ensures that a file of that name does not 
exist in the group. Each time the job is run, the old WORKFL 
is purged. If the file has already been purged, the message 
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aa Simultaneously press Control key and Y to stop adding lines. 
(am Save job control commands in file named ACRJOB. 
= Terminate Editor. 


FILE NOT FOUND is printed. A new WORKFL is then 


created with the BUILD command. As a precaution in case 
the job does not run properly, the WORKEFL is a permanent 
disc file rather than a temporary file. 


(9) A file referenced as NEWCHK in the program is equated to 


an actual disc file named DCHKRD. 


A file referenced as OUT in the program is equated to a file 


Q © 


name CUMACRC which is a permanent disc file. The ACC= 
APPEND parameter specifies that data is to be added follow- 
ing the existing data in the file. If this parameter is omitted 
and data is written in sequential access mode, data will be 
written to the beginning of the file. 


The ACRUPD program is the second program in the job to 
be executed. 


The operator is notified that the job is complete. The oper- 
ator also receives a system message to this effect but a more 
specific message is sometimes helpful. 


run application program named ACRUPD. 
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> 


C 


= 9 


PRPRPPRPPRPPRPRP PRP Pre eet 


— 


If this job is punched in cards it looks like this: 


:EDJ 
-TELLOP ae atte evaenaenaeseeeeaana 
:TELLOP # JOB XX34 END # 
-TELLOP ## #2 ee ee eeneeeeeeeeeaeane 
>RUN ACRUPD 
>:FILE OUT; DEV=LP,13,3; CCTL 
:FILE CUMACRC=DCHKRD; ACC=APPEND 
>:BUILD WORKFL; DISC=1000; REC=-80,3,F ,ASCII 
>:PURGE WORKFL 
:TELLOP ##* JOB XX34 FCOPY COMPLETE#*## 
>EOD 
EXIT 
FROM=#IN;TO=DCHKRD;NEW; EBCDICIN;SUBSET; SKIPEOF=1 
>RUN FCOPY.PUB.SYS 
>FILE IN; DEV=TAPE; REC=40,3,F,ASCII 
:PURGE DCHKRD 


>TELLOP tt Fa eee ears eee RFSSHEESHSHSHERSHRESESHSERH SERRE SH DES 




















:TELLOP 4 
:TELLOP *# TO REPLY TO IT. 
:TELLOP # MOUNT “’CHKRCVD’ TAPE AND STANDBY 
:>TELLOP * ACCOUNTS RECEIVABLE UPDATE RUN - 
:TELLOP* 
:>TELLOP # JOB XX34 STARTING 
:TELLOP # 
-TELLOP Fe se eee eee eSFFFFsFFHF RHF FHRHKAFAHETHRARRR ECS HRRRRRR RED RR ERE E 
“COMMENT Sse. H2 2-232 2252242 SSeS aS SSeS ee ee 
> COMMENT ACCOUNTS RECEIVABLE UPDATE 
[COMMER SHH aea=—— SoS soe Se aes see se e= 
: COMMENT | 


>JOB XX34,MEMBER1 .PAYACCT , GROUP? 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Sections IV and VI) 
EDIT/3000 Reference Manual 
FCOPY Reference Manual 
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executing job control commands stored in a file 


You can initiate a job that is stored in a file by logging on in ses- 
sion mode and using the :STREAM command. 


ea EU a eR 


sHELLO MEMBER1 .PAYACCT 


HP3000 / MPE ITI B.00.00. 


>STREAM ACRJOB 
#J35 


ams Initiate a session. 


TUES, MAY 16, 


1978, 2:00 PM 


== Initiate job stored in ACRJOB file. 





You can log on with the same user name, account, and group used 
in the :JOB command of the job you want to stream or with some 
other user, account, or group names as long as you have access to 
the file in which the job is stored. 


If you use the exclamation point (!) as a substitute character for 
the colon (:), you only need to specify the input file containing the 
job. However, if you created the job with some other character, 
that character must be included with the :STREAM command. For 
example, if the job commands are preceded by an at-sign (@), the 
‘STREAM command must look like this: 


“STREAM ACRJOB,@ 


to notify MPE that the substitute character is @. If you provide no 
character, MPE assumes you have used the default (the exclama- 
tion point). 


The :STREAM command is useful if you want to initiate a job in 
the midst of a session and continue operating in session mode. The 
system spools the job to a disc file, schedules the job to begin as 
soon as possible, and prompts for the next command in your 
session. 


When the job begins execution, the following message is printed 
on the system console: 
/17:53/#535/LOGON FOR: MEMBER1.PAYACCT ONLDEV#5 


naa. job number 


time 


The :TELLOP commands display the following message on the 
console: 


17:S3/#J3Z5 SSF SRFSRARFRFRSFFHFFEHFFFFRHFHRFRERHRRHRRFRRRR TE +H 


17:53/#J35/ + 
17:53/ #J35/% 
17:53/#J35/# 
17:53/ #J35/* 
173S3/ #J3S/ * 
172537 #J35/ * 


MOUNT 


JOB XX34 


STARTING 


ACCOUNTS RECEIVABLE UPDATE RUN - 
“CHKRCVD “ 
TO REPLY TO IT: 


® 
x 

* 

TAPE AND STANDBY * 
2 

z 

* 


17:S3/#I3ZB5/ FFF HFRFSHSRHSFSFFHFSFHFFFSHPHFHRRSRHRAS 


PRERPRPPRPRFRFPRFRPRP RP eee es 


eu lwue 





When the IN file is opened by FCOPY, this message appears on the 
console: 


?10/17:53/#J35/25/LDEV# FOR “IN” ON TAPE (NUM) 


to which you or the console operator must respond (after the tape 
is mounted and the device is in the online state): 


=REPLY 25,8 


Press control A, type REPLY, type the process identification num- 
ber (25), and the logical device number of the tape unit (8). 














When the last four commands are executed, these messages appear 
on the console: 


MS/17:SS/#J35/s eee ee aeeeeaeaeaaeanana 
MS/17:55/4#J535/% JOB XxX34 END # 
MS/17°-SS/ #35 / tee ERR ER EREE ES 
ST/17:55/#J35/LOGOFF 


The job is listed on the line printer or $STDLIST device. For 
example: 


>JOB XX34,MEMBER1.PAYACCT, GROUP' 








I PRI= DS; INPRI= 13; TIME= ? 

a JOB NUMBER = #J35 

i THU, JAN 27, 1977, 5:53 PM 
HP32002A.00.05 

I 
: COMMENT 
:COMMENT --------------------------------------- 
: COMMENT ACCOUNTS RECEIVABLE UPDATE 
:COMMENT --------------------------------------- 
-TELLOP RHERRFR THK RHF ARHFRF SRK RFRFFRKPRRRHFHREAHRHRAFH HHH HRERRARS 
>TELLOP- ¥#* JOB XX34 STARTING 
>TELLOP # * 
>TELLOP *# ACCOUNTS RECEIVABLE UPDATE RUN - * 
>TELLOP # MOUNT “CHKRCVD’ TAPE AND STANDBY * 
:TELLOP +# TQ REPLY TO IT. % 
>TELLOP ~# % 
-TELLOP ARERR HREHSHRHSHRHRSFHF RHEE HHH R ARERR RHSBE 


>PURGE DCHKRD 
sFILE IN; DEV=TAPE; 
>RUN FCOPY.PUB.SYS 
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REC=40,3,F ,ASCII 


PAGE 1 HEMILETT-PACKARD 32212A.1.03 FILE COPIER THU, JAN 


FROM=*IN; TO=DCHKRD; NEM; EBCDICIN; SUBSET; SKIPEOF=1 
EOF FDUND IN FROMFILE AFTER RECORD 5S 


G6 RECORDS PROCESSED ### 9 ERRORS 
EXIT 


END OF PROGRAM 
-TELLOP ## JOBXX34 FCOPY COMPLETE #*#* 
:PURGE WORKFL 
FILE NOT FOUND 
-BUILD WORKFL; DISC=1000; REC=-80,3,F,ASCII 
:FILE HWEbMICHK=DCHKRD 
:FILE OUT=CUMACRC; ACC=APPEHD 


>RUN ACRUPD 

RECORDS ADDED CCOMPANY AND AMOUNT) 
JONES MFG., INC. $115.35 
ACME WIDGET $ 43.67 

X¥ &€ R SURPLUS : $489.01 


END OF PROGRAM 


-TELLOP HRP SHHRRRSR EES 


:TELLOP #* JOB XX34 END * 
-TELLOP HPFFFFSFFSSFRSHRFSRHRR RHE S 
:EDJ 
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A 


a fd a 


2 


EkKk EE 


ee ee ee ee ee ee ee ee ae ee 


You can check the status of your job by entering the :SHOWJOB 








command. 
: SHOWJOB 
JOBNUM STATE IPRI JIN JLIST 
#5585 EXEC SS 52 
=> #535 EXEC QUIET SS LP 
#5576 EXEC a2. ag 
#5510 EXEC 44 44 
#5546 EXEC 34 34 
6 JOBS: 
0 INTRO 
0 WAIT; INCL O DEFERRED 
G EXEC: INCL S SESSIONS 
Yn SUSP 
JOBFENCE= 0; JLIMIT= 3; SLIMIT= 
The status of the job is: 
| #535 job number 35 
EXEC job is in execution state 
~ QUIET the SETMSG OFF command is in effect 
5 the logical device number of the standard 
input device is 5 
S the standard input device is spooled 
LP the standard list device is device class LP 
(line printer) 
THU 5:53P 


MEMBER1.PAYACCT 


the job was introduced at 5:53 p.m. on 


Thursday 


by user MEMBER1 of the PAYACCT 


account 


INTRODUCED 
THO S52:535P 
THU §3852P 
THU 4:20P 
THU T23264P 
THU 2tTSre 
16 
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JOB NAME 


MEMBER1.PAYACCT 
MEMBER1 .PAYACCT 
EEC ..HUSEBY 
GINNY.SMITH 
MANAGER .2 





For a complete explanation of the various :SHOWJOB formats and 
options, as well as other job related commands, see the WPE Com- 
mands Reference Manual, Section VI. 


ADDITIONAL INFORMATION: 
MPE Commands Reference Manual (Sections IV and V1) 


maintaining a current set of production data files 





The technique illustrated in this example can be used for maintain- be run each day. Each run creates a file and it is important to save 
ing a set of production data files created by the most recent job the files created for at least four days. The job shown below will 
runs. For example, a program to update the shipmerit records may maintain such a set of four files. 

: JOB MEMBER1.PAYACCT, GROUP! sm Job begins. 


PRIORITY=ES. INPRI=8 
JOB NUMBER = #J150 
THY, JAN Te, Tose 
HP32002B.00.00 


:COMMENT -------------------------------------- 


>: COMMENT DAILY SHIPMENTS UPDATE 

SCOPING mite ee os ot ees oe ee eee ot tees Ge oe oe eo ee OS Se Or 

-PURGE WORKTEMP <= Work file is purged. 

FILE NOT FOUND (== |f WORKTEMP does not exist, message is printed. New work file is 
SBUILD WORKTEMP: DISC=500 created. 

sRUN SHIPUP Se cast Today's run of SHIPUP uses the work file for output. 


END OF PROGRAM 





ePURGE FILE (=a If program runs successfully, oldest file, FILE1, is purged. 
sRENAME FILES.FILE m= FILE2 is renamed FILE1. 

sRENAMEC FILES,FILES FILES is renamed FILE2. 

-RENAME FILE4,FILE3 FILE4 is renamed FILES. 

>RENAME WORKTEMP,FILE4 Work file is renamed FILE4. 

cE DJ m= Job terminates. 

GPU SEUC.=3. ELAPSED FIN:=1. THU, JAN 12, 1978, 32:01 PM 

The line printer listing shown above is printed when the job is exe- Before the first execution of this job, you must build files FILE2, 
cuted. The job may be punched in cards and entered through a FILE3, and FILE4 or the :RENAME command will fail. Alterna- 
card reader or stored in a file and initiated with a :STREAM com- tively, you can insert a :CONTINUE command before each :RE- 
mand. NAME command and the job will continue in spite of the 


:-RENAME errors. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Sections IV and V1) 
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passing data in temporary files 


There are two techniques for passing data from one program to 
another through a temporary disc file. The first one uses the TEMP 
parameter of the :FILE command. 





SFIiLe UWS, NEWS REC? "66 yp, Astiis¢ Terr ean Define a temporary file called X to be used for the program’s 


-=RUN PROGI OUT file. 

FHTER DATA mm PROG1 prompts for some data. 

1358-22-77 771 JORASUN MYRLE M 

ENTER DATA 

i Comm PROG1 recognizes an asterisk as an indication that there is no 
more data. 


END OF PROGRAM 


-=FILE IH=X, OLDTEMP prem Specify the temporary file named X created by PROG1 as the file 
>RUH PROGe referenced by IN in PROG2. 
JOHNSON Gass PROG2 displays the last name from the temporary file’s record. 


END OF PPOGRAM 





The OLDTEMP parameter tells MPE that X is an existing tempo- A :BUILD command with the TEMP parameter can also be used to 
rary file. Since this is so, it will be deleted automatically at the end create the temporary file. 
of the session. 
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The second method for passing data in a temporary file is to use 
the system’s $NEWPASS/$SOLDPASS files. 





>RUN PROG1 


ENTER DATA 
135-222 77771 JDHNSON MYRLE M 


ENTER DATA 


2 


sFILE OUT=$NEWPASS; REC=-80,,,ASCII Geni Notify the system that the program file named OUT is to be the 


system temporary file named $NEWPASS. 


END OF PROGRAM =a When PROG1 closes the file named $NEWPASS, the system changes 


-<FILE IN=$OLDPASS 
>RUN PROG2 


JOHNSON 


END OF PROGRAM 


The file named $OLDPASS exists until the session or job termi- 
nates or another file referenced as $NEWPASS is closed. If either 
of these events occurs, the current $OLDPASS file is deleted. 


The :BUILD command cannot be used to create a temporary file 
named $NEWPASS. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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its name to $OLDPASS automatically. Therefore, PROG2’s file 
named IN can be equated to $O0LDPASS which contains the 
desired data. 


NOTE: The :PREP command and compilers may also use 
S$NEWPASS and $OLDPASS by default, so you must be 
careful when using them in jobs that also compile or pre- 
pare programs. 





PREPPRPPRFRPRP RP Pests 
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— 
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creating conditions in a test file using the editor 


% 


The Editor can be used to change specific information in a data 
file. You may find this technique useful when testing an applica- 
tion by creating different conditions in a test file. 





fFEDITOR = Initiate Editor execution. Note that abbreviated versions of the 
Editor commands are used in this example. 

HP32201A.5.01 EDIT/3000 TUE, JAN 25, 1977, 1:06 PM 

CC) HEWLETT-PACKARD CO. 1976 





/T EMPLOYEE ,UNN == Move EMPLOYEE file contents into work file. 

/Ca fev7e TO “"W" IN TO715 Gzzz Change character position 72 to an ‘“‘N” in records 10 through 15. 
/K EMPTEST2,UNN Save revised file in a new file named EMPTEST2 and terminate 
/E Editor. 

The CQ command is an abbreviation of the CHANGEO command. ing character position and stopping character positions are indi- 
If you include the OQ, the changed lines are not displayed as they cated by 72/72. If you omit the stopping character position (or 
are changed. column) the “N” is inserted before column 72. 


ee ee ee ee ee ee ee ee | 


If you omit the IN 10/15 clause, only one record is changed and it 
is the first record in the file just moved to the work file. The start- 






/T EMPLOYEE ,UNN = Move EMPLOYEE file contents into work file. 


| 7FIMD *SPTEGLE™ == Locate record for employee named SPIEGLE. 
a ) oH 275-86-38275SPIEGLE ROSALIE I 22 . SRD STREET SJ FSSFSS 
' T¥ line number 5 _ . 
ndicates character position 13 
Jj oe tt3 yaa 
/CHANGE 1711 TO ™ =™ Change character positions 1 through 11 to blanks. 
ai 5 SSPIEGLE RDSALIE I 22 N. 3RD STREET SJ FSSF35 
YY 
di /K EMPTEST1,UNN = Save revised file in a new file named EMPTEST1 (without line 
aa numbers). 
To test a program that is supposed to detect a missing social about Spiegle was not known before the FIND command was 
security number, the social security number in a specific record used. If the line number is known, the Editor CHANGE or MOD- 
in the file is changed to blanks. This example assumes that the IFY command can be used with the line number specified as the 


record number for the EMPLOYEE record containing information rangelist. 


Lhe & 
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In the next example, all employee records that contain a salaried 
employee code (S) and a full-time code (F) are changed to an 


hourly employee code (H). 


== Move EMPLOYEE data into work file. 
axa Set left margin at character position 58, and request short messages 


/T EMPLOYEE,UNN 

/SET LEFT=S8, SHORT 
/FINDQ@ FIRST 

/WHILE 

/ rin “or 

/ CHANGE SS/58 TO “H™ 


5 SF35000 0 7S0yvY¥ 
‘53 3)” 

= HF 35000 0 7S50YY 

6 SF35000 4 ONY 
«SS )* 

6 HF 35000 4 ONY 

7 SF20000 2 ONY 
css 3* 

7 HF20000 2 OYY 

8 sFego0ood 3 OYY 
«SS )* 

8 Hrevood 3 OYY 

9 or 1S000 §& OYY 
«58 )* 

= HF15000 S OYY 

10 SF1S5000 2 ONY 
cS8 )* 

10 HFTSOO00 2 ONY 

11 sFeeood 1 ONY 
«SS )* 

11 HF22000 1 ONY 

12 SF22000 0 UY" 
«S58 )* 

12 HF22000 0 OYY 

12 SF27000 2 0YY 
cS8 )* 


with SHORT parameter. Set pointer to beginning of work file. 
Enter WHILE command which causes next two commands to be 
repeated until the condition in the first command can no longer 
be met. 


(== Character positions 58 through 80 are searched for the string “SF.” 
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If the string is located, character position is changed to H. 


If you want to suppress the display of these lines, use the FINDO 
or FO and CHANGEO or CO commands. 


“~ 


eo 


PRFRPRPRP PRP RFR RP RRR RR eee 


_ 


New 


ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee oe ee | 


13 HF27000 2 OYY 
14 SFev000d 0 OYY 
css )* 
14 HF27000 O OYY 
j b= SF45000 O1000YN 
cS8 )* 
15 HF 45000 O1000YN 
#21#STRING NOT FOUND BEFDRE LIMIT ée== When the last record has been examined by the Editor this message 
AT DEPTH e is printed. Set the left margin to the first character position and 
/SET LEFT=1 save the file in a new file named EMPTESTS. 
/K EMPTEST3,UNN 


/E 
LS Lae aa eT hl a Re ee es ee aa 


The FINDQ FIRST command is not necessary if the data has just The SHORT option of the SET command inhibits display of the 
been moved into the work file but it should be used after any Ed- commands in the WHILE block. 

itor commands that move the pointer, for example, LIST or 

MODIFY. 


ADDITIONAL INFORMATION: 
EDIT/3000 Reference Manual 
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scanning for conditions set in a disc file by an application program 


When you are developing application programs, you may want to value. One method for examining the file is to use the FCOPY 
examine a test file to see if a particular field contains the correct utility program. 





>RUN TESTPROG 


-RUN FCOPY.PUB.SYS (=a Initiate FCOPY execution after TESTPROG terminates. 


HP32212A.1.03 FILE COPIER €C) HEWLETT-PACKARD CO. 1976 
Copy each EMPLOYEE record that contains a ‘’Y”’ in character 


>FROM=EMPLOYEE; TO=; SUBSET=""Y¥", 71 position 71 to the terminal. 

#200 ama FCOPY warns that records are not same size. 

5c /~S3-31101 BOWERS SUSAN A 13 DAKWOOD DRIVE SC FSHF 400 1 OYY 
678-99-33444PARK RICHARD R 1290 FRIAR WAY CU MSHF 400 1 OYY 
039-23-510230SG00D JOSEPH K 4567 CALIF. ST. MV MSHF 450 3 ay 
e/o-GG6" 5c /S5F [EGLE ROSALIE I e@2 N. 3RD STREET SJ FSSF35000 0O 7SOYY 
499- 73-S24/7eP1lERTE EMMA R 460 SARATOGA AVE.SCLFMSF20000 2 OYY 
253-48-00033PAPADAKIS JAMES L 1347 KINGSWORTH CU MMSF20000 3 OYY 
537-58-23454MAC LEAN VINCENT T 819 PALD ALTO ST.MV MMSF15000 S OYY 
e12*83-95432FERGUSON KATHERINE L729 UNION AVENUE LG FMSF22000 QO OYY 
456-97-00S543G0MEZ ROBERT D 1331 POETT LANE SCLMMSF27000 2 0OYY 
322- 11-353 747VEE JANICE K 310 BEEKMAN PLACECU FSSF27000 QO OYY 
142-67-SS33SALEXANDER GEOFFREY N 702 CORVALLIS DR.SCRMSSF45000 O1000YN 
342-48-83295SPOWELL PATRICIA J 249 FREMONT AVE. LA FMHF 00 4 OYY 
244-75-3844SJENSEN HILDSA A 17650 SHADOW LANELG FMHF 1000 0 800YY 
466-39-443340RO02C0 JOSEPH N 112 BRIGHTEN AVE.MV MMHP 800 2 Oy 
5$89-24-21124SCRUGGS RODNEY xX 76 AUBURN DRIVE CU MMHP~ 800 1 OY Y 
300-24-36664JUNG DIANA T 965 WINCHESTER SCLFMHP S50 2 OYY 
EOF FOUND IN FROMFILE AFTER RECORD 19 

16 RECORDS PROCESSED *#* 0 ERRORS ieeiinal aamaiisiie 
PERIT 


END OF PROGRAM 
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When the TO-file is not specified, records are copied to the $STD- 
LIST device which is the terminal in session mode and the line 
printer in job mode. 


In this example, 16 of the 20 records in EMPLOYEE containa “Y” 
in character position 71. 





sEDITOR 


HP32201A.5.01 EDIT/3000 TUE, JAN 25, 
(CC) HEWLETT-PACKARD CO. 1976 
/T EMPLOYEE,UNN 
/SET LEFT=58, RIGHT=S58, SHORT 
/FIND FIRST 
1 H 
(S8 )* 
/WHILE 
/ FINDQ "S™ 
/ LIST + 
S S 
G S 
7 S 
8 S 
= 3 S 
10 S 
11 S 
ip S 
13 S 
14 S 
15 S 
#21*#STRING NOT FOUND BEFORE LIMIT 
AT DEPTH 2 
/E 
CLEAR? Y 


END OF SUBSYSTEM 


BREERERER RR RR RR ee eee eee eee 


c= Initiate Editor execution. 


1377, 


You can also use the Editor to list the relative record numbers of 
records containing particular characters in a specific field. 


1:03 PM 


Gam Move contents of EMPLOYEE into work file. 
Ga Set left margin and right margin to character position 58 and re- 


quest short messages. 


= Set pointer to first character position in file (within current mar- 


gins). 


femes Use WHILE command to search all records in the file for an “’S” 


in character position 58. List the records that contain an S. 


Gam This message is printed when the end-of-file is encountered. 
mms Terminate the Editor. 


Pe 22 MEET SYN ce DRAM STS Ne TP gL TES TET SM MP = SOOM SRE, Seal LS We ee cee Re MR Reco WE Sc) a Eee ns eA A eee eae 


The FIND FIRST command is only necessary if some Editor com- 
mand has moved the pointer from the first record. 





The addition of Q to the FIND command suppresses printing of 
each record when it is located. 


% 
tx ee 





ere ee AK 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
EDIT/3000 Reference Manual 
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Z —— : backup and recovery of files 


Making Backup Copies of Disc Files on Magnetic Tape or Serial Disc 
Restoring Disc Files from Backup Tape or Serial Disc 
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name, group name, and lockword). They can be copied back to the 





:sFILE BACKUP1; DEV=TAPE 


(em Define tape devicefile named BACKUP1. 


making backup copies of disc files on magnetic tape or serial disc 


The MPE :STORE command can be used to store one or more files disc with the :RESTORE command as shown in the next example. 
on a backup tape or serial disc. The files are copied in a special They can also be transferred to another 3000 system if that system 
format along with all descriptive information (such as account has an account, a user, and a group defined with the same names. 


2 | 
<STORE @.GROUP1; #BACKUP1; SHOW som Request that all files in GROUP1 be copied to the backup tape 
| LOCKWORD: CUSTOMER.GROUP1.PAYACCT ? and that the results of the store operation be displayed. 
4 LUCKWORD: FILEXYZ.GROUP1.PAYACCT? == You must provide lockwords for files that have them defined. 
| FILES STDRED =16 
: FILE .GROUP .ACCOUNT LDN ADDRESS 
: DISCARD .GROUP1 -PAYACCT 2 wis 3STe <== The logical device number of the disc from which 
DLSECE -GROUP1 -PAYACCT 2 4234542 the files are copied is 2. 
4 DISCFILE~GROUP’1 -PAYACCT ys 4161014 The address of each file is displayed in octal 
DISCFL .GROUPT -PAYACCT e zEFaSGY format. 
i EMP 1 .GRDUP1 .PAYACCT 2 %1665 
EMP? -GROUP1 -PAYACCT 2 41374 
| EMPALL .GROUP1 -PAYACCT 2 42614 
EMPFILE .GROUP1 -PAYACCT 2 4364711 
J q EMPLOYEE.GROUP1 -PAYACCT 2 31 7555 
: FILEDNE .GROUP1 -PAYACCT e 4/76 
J FILETWO .GROUPT1 -PAYACCT a 4241760 
FILEXXX .GROUP1 -PAYACCT 2 eeoSs1tS 
J FILEXYZ .GROUP1 -PAYACCT = 442426 
HOURLY .GROUP1 -PAYACCT c 4205422 
- SORTEMPL.GROUP1 -PAYACCT 2 42567 
7 XFILE .GROUP1 -PAYACCT 2 4341 
4 FILES NOT STORED = 1 
FILE -GROUP -ACCOUNT FILESET REASON <= The CUSTOMER file was not stored since 
all the lockword provided was incorrect. 
a CUSTOMER.GROUP1 -PAYACCT 1 FILE LOCKWORD WRONG 
SE SERENE "DCR ES 
» | 
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When the system file opens the TAPE, a message like the following 
one is displayed on the system console: 


14: 15/#S1123/55/LDEV# FOR “BACKUP1" ON 
TAPE (NUM)? 
=REPLY 55,7 


process identification 
number 


Respond with Control A, REPLY, the process identification num- 


ber, and the logical unit number of the tape device. 


The at sign (@) indicates that you want all the files in the specified 
group copied. If your log-on group is the group you want to copy, 
you can omit the group name and period preceding it. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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The asterisk preceding the BACKUP1 file name indicates that the 


file has been defined in a previous :FILE command. 


The SHOW parameter requests a summary of the results of the 
copy operation. 


If you are using a CRT instead of a hard copy device, use a :FILE 
SYSLIST; DEV=LP command to direct the list of files to the line 
printer. Otherwise you may lose information when the screen is 


filled. 


To copy the same set of files to serial disc, enter: 
:-FILE BACKUP1 ;DEV=SDISC 
:STORE @.GROUP1;* BACKUP1;SHOW 
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-FILE BACKUP1; 


*-RESTORE #BACKUP1 ; 
LOCKWORD: 


HP3000 / MPE III B.00.00. 


FILES RESTORED = 


>HELLO MEMBER1 .PAYACCT 


DEV=TAPE 


KEEPS 


To copy the files to the disc from a back up tape created with the 
‘STORE command, use the :RESTORE command. The :RE- 


restoring disc files from backup tape or serial disc 


STORE command can also be used to copy files from a tape 
created by the system supervisor using :SYSDUMP. 





ge Log on to account to which files are to be restored. 


TUES, MAY 16, 


Va7s, 


2:00 PM 


Ga Define tape devicefile named BACKUP1. Copy files from the tape 
to your log-on group and account (GROUP1 and PAYACCT in 
this example) if they are not there already. 


SHOW 
FILEXYZ.GROUP1 .PAYACCT? 


Ga Only four files are restored since remaining file 
names already exist in the group. If KEEP param- 
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FILE - GROUP -ACCOUNT LDN ADDRESS eter is omitted, file from tape would replace file 
EMPFILE .GRDUP1 .PAYACCT 2 4230 Ba ere eran Shane 
FILEONE .GROUP1 -PAYACCT e 42200513 . ; 
FILETWO .GROUP! .PAYACCT 2 2200713 she aise and are not located in the same are 
FILEXXX . U : = — that they were previously. 
FILES NOT RESTORED = 12 
FILE .GROUP ~ACCOUNT FILESET REASON 
DISCARD .GROUP1 -PAYACCT 1 ALREADY EXISTS 
DISGF -GRODUP 1 ~-PAYACCT 1 ALREADY EXISTS 
DISCFILE.GRDUP1 -—PAYACCT 1 ALREADY EXISTS 
DISCFL. -GROUP1 -PAYACCT 1 ALREADY EXISTS 
EMP 1 -.GROUP1 -PAYACCT 1 ALREADY EXISTS 
EMP2 -GRDOUP1 -PAYACCT 1 ALREADY EXISTS 
EMPALL -GROUP1 ~-PAYACCT 1 ALREADY EXISTS 
EMPLUYEE.GRDUPT -PAYACCT 1 ALREADY EXISTS 
FILEXYZ .GROUPT -PAYACCT 1 ALREADY EXISTS 
HDURLY .GRDOUP1 -PAYACCT 1 ALREADY EXISTS 
SORTEMPL.GROUP1 -PAYACCT 1 ALREADY EXISTS 
XFILE -GROUP1 -PAYACCT 1 ALREADY EXISTS 


The tape file name must be preceded by an asterisk to indicate it 
has been defined with a previous :FILE command. The files are 
copied to the group from which they came. The group must be 
either your log-on or home group. In this example they are cop- 
ied to MEMBER1’s home group, GROUP1. 


The KEEP parameter specifies that a file is not to be copied if a 
file with the same name already exists in the group. By using this 
parameter you can selectively load files without using a separate 
:-RESTORE command for each file. 


The DEV= parameter may be used with the :RESTORE command 
if you want the files to go to a particular device; for example, on a 
system which has one disc configured with device class name DISC 
and another with device class name DISCXXX. 


The system displays a message on the system console to request the 
logical device number for the tape file. 


710/10:13/#895/26/LDEV# FOR “BACKUP1” ON TAPE (NUM) 


=REPLY 26,7 
PIN 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
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Respond with Control A, REPLY, the process identification num- 
ber (PIN), and the logical unit number. 


Note that although the CUSTOMER disc file was not restored, it 
still exists in the group. The list of files resulting from the SHOW 
parameter includes only those files which are on the back up tape 
and not all files in the group. 


If you are operating in session mode, you may want to use the 
-FILE SYSLIST; DEV=LP command to direct the list of restored 
files to the line printer. 


To restore the same set of files from serial disc, enter: 
-FILE BACKUP1 :;DEV=SDISC 
-RESTORE *BACKUP1;@;KEEP;SHOW 
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private volumes 


- 


Private Volumes Facility 

Home Volume Set 

Creating a New File on a Volume Set 
Mounting and Dismounting Volume Sets 


- 
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private volumes facility 





Users with the Volume Set Usage (UV) capability can maintain 
files on private disc volumes. These private volumes consist of re- 
movable disc packs which, when mounted on a disc drive, can be 
accessed by MPE through the MPE Private Volumes Facility. 
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home volume set 


A home volume set is the volume set assigned to your group when 
the group is created with the :NEWGROUP command or altered 
with the :ALTGROUP command. Files belonging to the group are 
located on the home volume set; the home volume set is the set 
referenced by you when you log on under the group. The set need 
not be mounted until such time as you attempt to access file space 
in the set. At this time, MPE generates a console request for the 
Console Operator to mount the set. You can explicitly request that 
the volume set be mounted before any file access is attempted, and 
can release the set after you are through with it. 


creating a new file on a volume set 


Any MPE operation which creates a temporary or permanent file 
(Editor, :BUILD command, FCOPY, and so forth) will cause the 
file to be created on a volume set if the home volume set for the 
group/account is a private volume set. 


When creating a file on a home volume set with the :BUILD com- 
mand, the DEV parameter can be specified in one of the following 
ways: 


Idn 

devclass 
DEV = = 

*voname 

**volname 


The preceding parameters have the following meanings: 


Idn (logical device number) The file will be allocated to 
that /dn only if one of the volumes in the home 


volume set currently occupies the /dn. 


(device class) The file will be allocated within the 
home volume set’s volumes which currently reside 
on devices of this class. 


devclass. 


The file will be allocated to any of the volumes of 
the home volume set. (* is the’ default.) 


*voname (volume class name) If vcname is a member of your 
home volume set, the file is allocated to any of the 


volumes within the volume class. 


(volume name) If vo/name is a member of your 
home volume set, the file is allocated to that volume. 


**volname 
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An example of using the :BUILD command to create a new file on | 


a volume set/class is as follows: 
:-BUILD VFILE;DISC=500,10,1;REC=-80;DEV=VCLASS1 


Name of existing volume class 


NOTE 


A file may (depending on the DEV 
parameter specified) reside on more 
than one volume of a volume set, but 
must remain within that volume set 
(may not span more than one volume 
set). The restrictions are as follows: 


DEV=* The file may reside on more than one volume 
of the volume set. 
DEV=/dn The file is confined to that /dn. 


DEV=**volname The file is confined to the volume whose 


name is vo/name. 


DEV=devclass The file is confined to volumes which reside 


on devices of that device class. 


The file is confined to volumes within this 
volume class. 


DEV=“*vcename 
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mounting and dismounting volume sets 







You can initiate the mounting of a volume set by: 
1. Using the :MOUNT command (explicit job/session request). 


2. Using a command such as :BUILD which requires that the 
home volume set be mounted (implicit job/session request). 


3. Running a program or subsystem which requires access to a file 
of a group and account whose volume set is not mounted (pro- 
grammatic request). 


If the volume set is not physically mounted, MPE sends a message 
to the system console requesting the operator to mount the re- 
quired volume set. 


EXPLICIT JOB/SESSION MOUNT/DISMOUNT REQUEST. You 
can request a mount of a volume set during a job/session by en- 
tering the :-MOUNT command. A volume set so assigned for 
mounting can be released and made available by entering the 
:DISMOUNT command. This method of mounting/dismounting 
a volume set is used when only a few consecutive job/session steps 
require the same volume set. 


An example of the :MOUNT command is as follows: 


-MOUNT Specifies home volume set for log-on group 
and account. (Default if no parameter speci- 


fied.) 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
MPE Intrinsics Reference Manual (Section II!) 


‘MOUNT VCLASS1 Specifies volume class name VCLASS17. 


The requesting job/session is suspended until the mount is com- 
pleted or rejected. 


The :DISMOUNT command informs MPE that the specified vol- 
ume set is no longer needed by the requesting job/session. If there 
are no other users of the volume set, MPE sends a message noti- 
fying the Console Operator that the drives formerly in use are now 
available to the system. (Once the volume set is dismounted, the 
device(s) on which it resides are returned to the available state.) 


An example of the :DISMOUNT command: 


:DISMOUNT VCLASS1 


IMPLICIT JOB/SESSION MOUNT REQUEST. Various user com- 
mands which cause access to your log-on group’s home volume set 
will initiate mount requests if the volume set is not mounted al- 
ready. An example of one of these commands (:BUILD) is as 
follows: 


‘:BUILD VFILE;DISC=500, 10,1; REC=-80;DEV=VCLASS1 


PROGRAMMATIC MOUNT REQUEST. You may issue an FOPEN 
call referencing a file residing on an unmounted volume set; this 
causes an implicit user-initiated mount request. 
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MPE tape labels 


ae provides a capability which allows you to read and write 


labels on magnetic tape files. Labeled magnetic tape files can be 
used tot 


1. Identify magnetic tape volumes (reels). 


2. Protect tape volumes from inadvertent destruction due to 
overwriting. 


3. Protect private information. 


4. Facilitate information interchange between computer systems. 


With this MPE tape label capability, you can read, but not write, 
|BM-standard tape labels and you can read and write ANSI-stan- 
dard (American Standard Magnetic Tape Labels for Information 
Interchange x3.27-1969) labels. 


Additionally, you can write and read user-defined labels on labeled 
magnetic tapes. 


Due to MPE tape labels, one of the following messages will be dis- 
played on the system console each time a magnetic tape is mounted 
and recognized: 


hr: min/#00/VOL UNLABELED MOUNTED ON LDEV#n 


i, (if tape is unlabeled) 


hr: min/#O00/VOL volid (ANSI) MOUNTED ON LDEV#n 
(if tape has an ANSI-standard label) 


hr:min/#00/VOL volid (IBM) MOUNTED ON LDEV#n 
(if tape has an |BM-standard label) 


opening a labeled 
magnetic tape file 


The following convention must be followed in order to issue a 
:-FILE command for a labeled magnetic tape file: 


:-FILE formaldesignator=filename [/lockword}] 


where 

filename Consists of up to eight alphanumeric charac- 
ters beginning with a letter that names the file 
to be processed. The group name may be 
included. 

lockword Up to eight alphanumeric characters beginning 


with a letter that protects the file from illegal 
access. If byte 54 of HDR1 label is a space, 
there is no security protection for the file. If 
byte 54 is any other character, then security 
protection is associated with the file. MPE 
tape labels will ignore security for |BM-stan- 
dard labels. Security will also be ignored for 
ANSI-standard labels unless byte 54 = %230. 
If a Jockword is specified on an output file, 
then byte 54 of HDR1 label will be coded as 
%230 and the /Jockword will be written ina 
portion of the HDR2 label. This will enable 
users to read ANSI-standard and IBM-standard 
tapes written by other systems, but will pro- 
vide /ockword security for ANSI-standard 
labeled tapes written by MPE. 


For example, to open the file whose formal designator is TAPE- 
FILE under the actual designator TEST 1, enter: 


:-FILE TAPEFILE=TEST 1 
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writing a label 
on a magnetic tape file 


The :FILE command or FOPEN intrinsic is used to write ANSI- 
standard tape labels (MPE will not write IBM-standard labels). 


The LABEL parameter of the :FILE command is used to write a 
file label on magnetic tape. For example, the statement 


:FILE TAPEFILE=TEST1;LABEL=FIL001,ANS, 12/31/77,NEXT 


writes a file label as follows: 


Volume 
Identification: 


Label Type: 


Expiration 
Date: 


Sequence: 


FILOO1 
ANS (ANS!) 


12/31/77. This is the date after which the file 
can be overwritten. If you attempt to over- 
write the file before this date, MPE will send a 
message to the Console Operator asking for 
confirmation that such is really desired. This 
affords an extra measure of protection against 
inadvertently destroying a tape by overwriting 
when a WRITE RING is left in the tape by 
mistake. 


NEXT. Signifies that the tape is to be 
positioned at the next file on the tape. 


ADDITIONAL INFORMATION: 


MPE Commands Reference Manual (Section V1) 
MPE Intrinsics Reference Manual (Section III) 


reading a labe' | 
on a magnetic tape tile 
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See the MPE I/ntrinsics Reference Manual for information on 
reading a label on a magnetic tape file. 
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RR SS 3 fisting system information 


Reporting on the Use of Account and Group Resources 

Listing Information about Users, Groups, and Accounts 

The LISTDIR2 HELP Command 

= Listing Account Information 
Listing Group Information 

Listing File Information 
Listing File Security Information 
Listing Devicefile Information 
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reporting on the use of account and group resources 


J 


There are many ways to get information about system use. The your log-on group and account. If you are the account manager 
MPE :REPORT command displays accounting information about you receive information about all groups in the account. 





sHELLO MEMBER1.PAYACCT (=m Initiate session as user MEMBER1 of account PAYACCT. (By de- 
fault, the log-on group is MEMBER1‘s home group, GROUP1.) 


HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 


:REPORT €= Request information about PAYACCT and GROUP1. 
ACCOUNT FILESPACE-SECTORS CPU-SECONDS CONNECT-MINUTES 
/GROUP COUNT LIMIT COUNT LIMIT COUNT Lami £ 
PAYACCT 980 2% Lira % 4 1463 + % 
/GROUP1 O12 *# 163 +# 1438 * 
** indicates no limit is defined CPU time is the Connect time is 
total central pro- the amount of time 
cessor time used sessions have used. 





If you are the account manager, you receive information about all 
groups in the account. 


I ) sHELLO MANAGER.PAYACCT <== Account manager logs on to PAYACCT account. 


Jj HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM 
hes Define PRINTER as a devicefile with device class LP. Specify that 


J the report is to be printed on the PRINTER file instead of $STD- 
sFILE PRINTER; DEV=LP LIST (the default). The asterisk indicates the file has been defined 
eREPDRT, #PRINTER with a :FILE command. 


If the :REPORT command is used in a job, the report is displayed 
on the line printer automatically since the line printer is the $STD- 
LIST device in job mode. 


BEEREE LE 
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The line printer output looks like this: 


ACCOUNT FILESPACE-SECTORS CPU-SECONDS 
/GROUP COUNT LIMIT COUNT LIMIT 

PAYACCT 1918 lad 300 il 
/GROUP1 1765 iad e63 a% 
/GROUPe2 153 lial 14 ld 
/PUB 0 ial 23 4 


ADDITIONAL INFORMATION. 


MPE Commands Reference Manual (Section V) 
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CONNECT-MINUTES 


COUNT 


1577 
1510 
18 
49 


LIMIT 


%% 
4% 
% 4 
at 

































































The LISTDIR2 utility program (LISTDIR on pre-Series I! systems) 
displays information about your log-on account and groups, files 
and users in the account. You can request any type of information 
but your user name and account must grant you the appropriate 
capability or the information will not be supplied. System managers 
and account managers have access to more information than other 
users. 


The information is displayed on the $STDLIST device unless you 
use a :FILE command to specify some other device for the LIST- 
DIR2 output file. For example, if you are operating in session 
mode and want the information to be printed on the line printer, 
use this :F1LE command: 


:-FILE PRINTER; DEV=LP 


and include a back reference to the file PRINTER when you enter 
a LISTDIR2 command. 





ADDITIONAL INFORMATION: 
MPE System Utilities Reference Manual (Section VIII) 


listing information about users, groups, and accounts 


If you are a system manager, system supervisor, or account man- 
ager, you can request some of this information with the MPE 
commands: 


@ :LISTACCT 

@® :LISTGROUP 

@ :LISTUSER 

@ :LISTF (available to all users). 


However, the LISTDIR2 utility program displays the information 
in a more useful format. 


A user who does not have manager or supervisor capability is only 
permitted to list information about the log-on account, group, and 
user name. 


Now let’s look at some examples of LISTDIR2 information, as pro- 
vided to the account manager of the sample account PAYACCT. 


System Manager/System Supervisor Reference Manual (Appendix D) 


THE LISTDIR2 HELP COMMAND 


The first time you use the LISTDIR2 utility program you may 
want to ask for instructions with the HELP command. 





*-HELLO MANAGER.PAYACCT <*™ Log on to account in which you are interested. (You must have 
HP3000 / MPE III B.00.00. TUES, MAY 16, 1978, 2:00 PM access to the account). 
eRUN LISTDIR2.PUB.SYS qa Initiate execution of LISTDIR2 which is in the PUB group of the 
SYS account. 

LISTDIR2 (€B.DEC20.1) CCIHEWLETT-PACKARD CO. 1977 
NEW FEATURES: GENERIC NAMES 

MOUNT/DISMOUNT COMMANDS 
TYPE “’HELP’ FOR AID 


>HELP = Enter HELP to receive instructions. 


CONTROL-Y MAY BE TYPED ANYTIME TO STOP THE OUTPUT 
FROM ANY COMMAND. 


COMMAND SYNTAX IS: 
LISTACCT [<ASET>] (,<LISTFILE>] C€;3PASS] 
LISTGROUP [<GSET>] [,<LISTFILE>] €;PASS] <== Brackets indicate the parameter is optional. 
LISTUSER (C<USET>] (€,<LISTFILE>)] C€;PASS] 


LISTSEC CPSET? [Cs,*LISTFILE?] (14PASS] 

Ltatr <FSET> 1,“LISTFILE>] €;PASS) [ sMAP) 

HELP C<LISTFILES J 

EXIT 

<ASET> IS AN ACCOUNT NAME OR @. 

<GSET> IS A GROUP NAME, OPTIONALLY QUALIFIED BY AN 
ACCOUNT NAME; OR @, OPTIONALLY QUALIFIED BY 
AN <ASET>. : 


EXAMPLES: LISTGROUP MYGROUP .MYACCT 
LISTGRDOUP @.MYACCT 
LISTGROUP @.@ 
<FPSET IS A FILE NAME, OPTIONALLY QUALIFIED BY A 
GROUP AND ACCOUNT NAME; OR @, OPTIONALLY 
QUALIFIED BY A <GSET>. 


Viz 
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CONTINUE? CY/NDY If you do not want any more instructions, enter an ‘‘N” and press 
return. 
EXAMPLES: LISTF MYFILE.MYGROUP .MYACCT 
LISTF @.MYGROUP 


CLISTFILE> IS ANY VALID FILE DESIGNATOR, PRECEDED BY 
AN ASTERISK TO BACK-REFERENCE A :FILE 
COMMAND. WITHOUT AN ASTERISK, THE FILE 
DESIGNATOR MUST BE AN EXISTING TEMPORARY 
OR PERMANENT FILE. 
EXAMPLE: LISTACCT @, #PRINTER 

"PASS" PERMITS ACCDUNT AND SYSTEM MANAGERS TO DISPLAY 

PASSWORDS, LOCKWORDS, CREATOR ID’S, AND FILE DISC 

ADDRESSES. THE CREATOR OF A FILE IS ALSO PERMITTED 

TO DISPLAY DISC ADDRESSES AND THE CREATOR ID. 


"MAP™ PERMITS THE FILE CREATER AND ACCOUNT AND SYSTEM 
MANAGERS TO DISPLAY THE FILE EXTENT MAP. 


Here is an example of sending the LISTDIR2 information to the 
line printer: 


>} FILE PRINTER; DEV=LP = Define a file named PRINTER of device class LP and run LIST- 


sRUM LISTRIRG .FUB.SYS DIR2. 


LISTDIR2C00.00)9€C) COPYRIGHT HEWLETT-PACKARD CO 1976 
TYPE “HELP” FOR AID 


>LISTACCT PAYACCT,#PRINTER (em When you use a LISTDIR2 command, specify PRINTER as the list 
FEXIT file parameter using the backreference format *~PRINTER. 


END OF PROGRAM 
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The line printer listing looks like this: 


SHARE RHKHRESRKRSFSRARAG HRS 


ACCOUNT: PAYACCT 


DISC SPACE: 2874C€5) PASSWORD: ## 

CPU TIME: 341CSEC) LOC ATTR: £0 

CONNECT TIME: 1641¢CMIN) SECURITY--READ: AC 
DISC LIMIT: UNLIMITED WRITE: AC 
CPU LIMIT: UNLIMITED APPEND: AC 
CONNECT LIMIT: UNLIMITED LOCK: AC 
MAX PRI: 150 EXECUTE: AC 


GRP INX PTR: 41070 
USR INX PTR: 41067 
CAP: AM,AL,GL,ND,SF,IA,BA 


An explanation of this information is given in the Listing Account 
Information example which follows. 
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LISTING ACCOUNT INFORMATION 


If no account name is specified with the LISTACCT command, 


information about the log-on account is listed. 





>LISTACCT 

S#*HtRtRSKSRSSARRARRAR*A“AE 

ACCOUNT: PAYACCT 

DISC SPACE: 980¢€5S) PASSWORD: ## 

CPU TIME: 181€SEC) LOC ATTR: £0 
CONNECT TIME: 1466CMIN) SECURTTY=--READ: 
DISC LIMIT: UNLIMITED WRITE: 
CPU LIMIT: UNLIMITED APPEND: 
CONNECT LIMIT: UNLIMITED LOCK: 
MAX PRI: 150 EXECUTES 
GRP INX PTR: 41070 

USR INX PTR: 21067 


CAP: 


@em= Enter LISTDIR2 utility LISTACCT command. 


AM,AL,GL,ND,SF,IA,BA 


AC 
AC 
AC 
AC 
AC 


ACCOUNT: 
DISC SPACE: 


Joru TIME: 
CONNECT TIME: 


DISC LIMIT: 


CPU LIMIT: 


CONNECT LIMIT: 


account name 

number of permanent file sectors currently 
used by the account 

number of seconds of central processor time 
used by the account members since the ac- 
count was created or a :RESETACCT com- 
mand was last used 

number of minutes account members have 
been connected to the system in session 
mode 

maximum number of permanent file sectors 
the account members are authorized to use 
maximum number of seconds of central pro- 
cessor time the account members are author- 
ized to use 

maximum number of minutes of connect 
time the account members are authorized 
to use 


MAX PRI: 


GROUP INX PTR: 


USER INX PTR: 


CAP: 


PASSWORD: 


LOC ATTR: 
SECURITY: 


highest subqueue priority an account mem- 
ber can request for a process 


information used by systems engineers 


capabilities available to account members, 
see the System Supervisor/System Manager 
Reference Manual for a complete description 
account password (available only to the 
system manager) 

local attribute assigned to account 

type of security restrictions applied to files 
in the account 

(In this example, only account members 
(AC) are allowed any type of access to the 
file and each account member is granted the 
same type of access at the account level.) 
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LISTING GROUP INFORMATION 


List information about the log-on group PUB. (No group name is 
specified.) 





>LISTGROUP (= Enter LISTDIR2 utility LISTGROUP command. 


BSRSRSRSRSBRRRSKRARRRARAR*A 


GROUP: PUB.PAYACCT 


DISC SPACE: OCS) PASSWORD: ## 

CPU TIME: 13SEC) SECURITY--READ: ANY 
CONNECT TIME: 22€MINd WRITE: AL ,GU 
DISC LIMIT: UNLIMITED APPEND: AL,GU 
CPU LIMIT: UNLIMITED LOCK: AL ,GU 
CONNECT LIMIT: UNLIMITED EXECUTE: ANY 
PILE INA PTIRE§ 21077 SAVE : AL ,GU 
CAP: IA,BA 


List information about GROUP2. 


Pe PPP RFP RP RP RP RPA AeA Aa ee 


»>LISTGRODUP GROUP2 (e™ Enter LISTDIR2 utility LISTGROUP command. 


eee nvveeseseteseseterseseateaee et 


GROUP: GROUP2.PAYACCT 


DISC SPACE: 68C€9S) PASSWORD: #*# 

CPU TIME? 4€5EC) SECURTTY=-READ: GU 
CONNECT TIME: SCMIND WRITE: GU 
DISC LIMIT: URLIMITED APPEND: GU 
CPU LIMIT?’ URLIMITED LOCK: GU 
COMNECT LIMIT: UNLIMITED EXECUTE: GU 
FILE INX PTR: £1101 SAVE? GU 
CAP: IA,BA 
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BEE E CG 


GROUP: group name and account name SECURITY: type of security restrictions applied to files 
DISC SPACE:, CPU TIME:, CONNECT TIME:, DISC LIMIT:, CPU in the group 

LIMIT:, and CONNECT LIMIT: have the same meaning as they do (In this example, any system user (ANY) 
with account but relate only to the specified group. can read the files or execute the programs 
FILE INX PTR: used by systems engineers belonging to the PUB group, but only ac- 


count librarians (AL) or group users (GU) 
can access files any other way. Only group 


users can access the files belonging to 
PASSWORD: the group password (available only to system GROUP2.) 


manager or account manager and displayed 
only if pass parameter is specified) 


LISTING USER INFORMATION 


CAP: capabilities available to programs saved in 
the group 


To list user information, use the LISTDIR2 utility LISTUSER 


command. 

LAS I A SE es 

*LISTUSER © em List information about each account user. (At sign (@) indicates 

HHPRFHHFHRFRRFSRRRRRR AS all users.) 

USER: MANAGER.PAYACCT If no user name is specified and the at sign is omitted, information 
about the log-on user name is displayed. 

HOME GROUP: PUB PASSWORD: ## 

MAX PRI: 150 LOC ATTR: Z0 


LOGON CNT: 1 
CAP: AM,AL,GL,ND,SF,IA,BA 
RERSRRRHSRERRPRERBRES 


USER: MEMBER1 .PAYACCT 


HOME GROUP: GROUP 1 PASSWORD: #*# 
MAX PRI: 150 LOC ATTR: £0 
LOGON CNT: 0O 

Car: ND,SF ,;1A, 8A 
BRBPERRRRSRKCRKARARAARAAE 


USER: MEMBER2.PAYACCT 
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HOME GROUP: 


MAX PRI: 


LOGON CNT: 


GROUP 1 PASSWORD: ## 


LOC ATTR: £0 


CAP: ND,SF,IA,BA 


SRRERFRRSRSERERPERARERRSA 


USER: MEMBERA.PAYACCT 


HOME GROUP: 


MAX PRI: 


LOGON CNT: 


GROUP2 PASSWORD: ## 


LOC ATTR: %0 


CAP: ND,SF,IA,BA 


HREEFBRERFRBBRERERSEREKRBRARRA 


USER: MEMBERB.PAYACCT 


HOME GROUP: 


MAX PRI: 


LOGON CNT: 
CAP: ND.SF.IA.BA 





USER: 

HOME GROUP: 
MAX PRI: 
LOGON CNT: 
CAP: 
PASSWORD: 


LOC ATTR: 


GROUPe2 PASSWORD: ## 


LOC ATTR: 40 


user name and account name 

user’s home group 

highest subqueue user can request for a pro- 
cess 

number of users currently logged on to the 
system with this user name 

capabilities granted to the user 


user’s password (available only to account 
manager or system manager and available 
only if PASS parameter is specified) 


local attribute assigned to user 
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LISTING FILE INFORMATION 
BR RD a Se A ST 


>LISTF EMPLOYEE.GROUP1 (™ List intormation about the file named EMPLOYEE that belongs 


eee ee eee ee eee ee ee ee to GROUP1. 


FILE: EMPLOYEE .GROUPT .PAYACCT 

FCODE: 0 FOPTIONS: ASCII,FIXED 

BLK FACTOR: 3 CREATOR: #*# 

REC. SEIZE: SOULE? LOCKWORD: ## 

BLK SIZE: 120CW) SECURITY--READ: ANY 

EXT SIZE: 1545) WRITE: ANY 

# REC: 20 APPEND: ANY 

# SEC: 15 LOCK: ANY 

# EXT: 1 EXECUTE: ANY 

MAX REC: 40 ##SECURITY IS ON 
MAX EXT: 1 COLD LOAD ID: 412744 

# LABELS: 0 CREATED: FRI, 21 JAN 1977 
MAX LABELS: 0 MODIFIED: FRI, 21 JAN 1977 
DISC DEV #: 2 ACCESSED: FRI, 21 JAN 1977 
DUSe TYPE: OU LABEL ADR: ## 

DISSE SUBTYPE: 3S SEC OFFSET: 41 

CLASS :DISC FLAGS: NO ACCESSORS 

FCB VECTOR: 40 


FILE file name, group name, and account name MAX LABELS: maximum number of user labels allowed 

FCODE: file code DISC DEV #: logical device number of the disc device 

BLK FACTOR: number of logical records per block DISC TYPE: device type as defined during system config- 

REC SIZE. record size in bytes or characters uration 

BLK SIZE: block size in words DISC SUBTYPE: device subtype as defined during system con- 

EXT SIZE: extent size in sectors figuration 

# REC: number of logical records in use CLASS: device class name 

# SEC: number of disc sectors in use FCB VECTOR: used by systems engineers 

# EXT: number of extents currently allocated FOPTIONS: file characteristics as defined in FOPEN in- 

MAX REC: maximum number of records allowed in file trinsic<opvons parameter. 

MAX EXT: emtierie: tain dt dutatinn Hindi Rar Win CREATOR: user name of file creator (available only to 
file creator or account or system manager 

# LABELS: number of user labels created 
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and displayed only if PASS parameter is 
specified) 


LOCKWORD: 


SECURITY: 


COLD LOAD ID: 


file’s lockword (available only to account or 
system manager and displayed only if PASS 
parameter is specified) 


security provisions defined for the file 

(In the example ANY indicates that any user 
can have any type of access that is also al- 
lowed at the account and group levels.) 


ON 


**SECURITY is indicates whether file 
OFF 


security has been released or secured. 


number identifying the current cold load 
when this file was last closed 


The System Manager/System Supervisor Reference Manual des- 
cribes file information in more detail. If the file is a program file, 
additional information is displayed. 
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CREATED: 
MODIFIED. 
ACCESSED: 


LABEL ADR: 


SEC OFFSET: 


FLAGS: 


date when file was created 

date when file was last modified 

date when file was last accessed 

disc address of disc file label (available only 
to creator or account or system manager) 
when added to label address, address of first 
logical record of file 

specifies why file is locked or if it is not 
locked specifies NO ACCESSORS (Check 
this if you cannot gain access to a file.) 





~— Mm YRS 


Sa alll cal eal eal ell alll onli call elation itn len tenis 


_ 


"EBREBERBEHERBHBBERBRBBRBRBRBaBaBABRBBBRBBD 
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LISTING FILE SECURITY INFORMATION 





»>LISTSEC FILEXYZ.GROUP1 <*™ List file security information for file named FILEXYZ in GROUP1. 
eseeaeeeaeeseeaeseaeaeeneane eh 


FILE: FILEXYZ.GROUP1 .PAYACCT 


SECURITY--READ: AC 
CACCT) WRITE: AC 
APPEND: AC 

LOCK: AC 

EXECUTE: AC 


SECURITY--READ: GU 
CGROUP ) WRITE: GU 
APPEND: GU 


LOCK: GU 
EXECUTE: GU 
SAVE: GU 
SECURITY--READ: ANY FCDDE: @ 
CFILE)D WRITE: ANY CREATOR: #2 
APPEND: ANY LOCKWORD: #7 
LOCK: ANY ##SECURITY [IS ON 


EXECUTE: ANY 


FOR MANAGER.PAYACCT:READ,WRITE,APPEND,LOCK,EXECUTE 
a SS 


FILE: file name, group name, and account name CREATOR: file creator’s user name (available only to the 
creator or system or account manager and 


SGGUhL! Y: account level security provisions for file 

(ACCT) (In this example, account members (AC) can displayed only if PASS parameter is speci- 
access the file in any way.) fied) 

SECURITY: group level security provisions for file LOCKWORD: file’s lockword (available only to the system 

(GROUP) (In this example, group users (GU) can ac- or account manager and displayed only if 
cess the file in any way.) PASS parameter is specified) 

SEGUAIT ¥: file level security provisions for file **SECURITY IS ON Tells whether file security has been re- 

(FILE) (In this example, any user who passes the OFF leased or secured. 
group and account levels of security can ac- FOR actual access permitted the log-on user. 
cess the file in any way.) MANAGER.PAYACCT: The account manager overrides this 

FGODE:; file code security. 
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listing devicefile information 


If you want to know the status of devicefiles you can use the 
“SHOWIN and :SHOWOUT commands. The :SHOWIN command 
displays information about all input devicefiles existing in the sys- 
tem, or specific information about all or anv of them. 





>SHOWIN (eas Enter command without any parameters. Information about your 
session's files is displayed. 

DEV/ CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C 

29g #1238 #5210 $STDIN OPENED (== Status of $STDIN file is displayed. 

5 #1243 CARDS READY 8 


MEMBER1.PAYACCT 
Spooled devicefile is ready. This file consists of a 


:DATA command and data entered through the 


ec FILES: card reader. 
0 ACTIVE 
1 READY: INCL 1 SPOOFLES, 0 DEFERRED 
1 OPENED; INCL 0 SPDOFLES Ces: CARDS file is ready. The spooled file coneists of 
0 LOCKED: INCL 0 SPOOFLES dex B disc sectors. 
1 SPODFLES: 8 SECTORS 





The first line of information tells the status of the $STDIN file The summary of file information indicates that 2 input devicefiles 

which is the standard input device for session number #5210 currently exist for your session; one is a spooled file (spoofle) in 

(MEMBER1’s current session in which the :SHOWIN command has the READY state and one is a regular file that is open. 

been entered.) The logical device number of the terminal on which 

this session is running is 29 and the device file id number is #1238. The :SHOWIN command parameters allow you to be selective in 
the information you display. These are described in the WPE Com- 

The second line of information tells the status of a spooled file mands Reference Manual with several examples of their use. 

named CARDS that has been read into logical device number 5 

(the card reader). It has been assigned device file is #1243 and is 

ina READY state. This file is using 8 sectors of disc space. 
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Here is an example of the :SHOWOUT command. 
See UT SR ST a UE Se 


-FILE PRINTER;DEV=LP <= PRINTER is a devicefile with device class LP. 
-RUN LISTDIR2.PUB.SYS em The LISTDIR2 utility is executed. 


LISTDIR2€00.00)€C) COPYRIGHT HEWLETT-PACKARD CO 1976 
TYPE “HELP*’ FOR AID 


>LISTF @,#PRINTER x= A list of information about all files is to be displayed on the line 
SEXRTT printer. 
END OF PROGRAM 
-SHOWOUT STATUS =a The :SHOWOUT command lists the status of all current output 
91 FILES: devicefiles if the STATUS parameter is specified. 
1 ACTIVE 1 devicefile is active and 1 is in a READY state. 
1 READY; INCL 1 SPOOFLES, 0 DEFERRED It is a spooled file. 19 files are open including 1 
19 OPENED; INCL 1 SPOOFLES spooled file. A total of 3 spooled files exist and 
Q LOCKED; INCL O SPOOFLES consist of 656 disc sectors. 
3 SPOOFLES: 656 SECTORS 
DUTFENCE=1 
, The :SHOWOUT command with the SP parameter displays infor- 
:SHOWOUT SP mation about currently spooled files. 
Doever DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C 
6 #0603 #5323 PRINTER ACTIVE 156 + 12 1 
OUTFENCE=1 


a ae a ee eee ae a ee ee ee 


The spooled file named PRINTER is in an ACTIVE state (being 13 (by default). Rank indicates the order in which the file was 
printed). It is logical device number 6 (the line printer) and is entered in the system with respect to other files. #C indicates 
assigned device file id #0603. The file belongs to session number the number of copies requested, in this case, only 1. 

#S$323. The file is 156 disc sectors long and has output priority 


ADDITIONAL INFORMATION: 
MPE Commands Reference Manual (Section VIII) 
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KSAM files 


Creating a KSAM File 

Copying an MPE File to a KSAM File 
Copying a KSAM File to the Terminal 
Changing the Name of a KSAM File 
Deleting a KSAM File 





creating a KSAM file 


/ 


A KSAM file must be created with the KSAMUTIL program’s 
BUILD command, or with the FOPEN intrinsic. Do not use the 
MPE :BUILD command. Here is an example of using KSAMUTIL. 
RAMBLES NaS TL NS TS ET EST 


-RUN KSAMUTIL.PUB.SYS = Initiate execution of KSAMUTIL. 

HP32208SA.00.00 FRI, FEB 4, 1977, 2:01 PM 

*BUILLD KFILEsREC=- 72 ,1,.F,A€SCILE Gomme: KSAMUTIL prompts for a command with the greater than (>) 

> *KEYFILE=KPF ILEKEYs symbol. Create a file named KFILE with a key file named KFILE- 

> fREV#G4 Toy lep pe DUr_lICares KEY. The ampersand (&) is used to continue the command on the 

> IKE Y=. le, 1» .JUPLICATES next line. 

> sFIESTREC= 7 

>VERIFY Sas You can use the VERIFY command to get information about the 
file. 


WHICH C1=FILE INFO, 2=KSAM PARAMETERS, 3=KSAM CONTROL, 4=ALL, S=NONE)?71 


KFILE.GROUP1.PAYACCCT CREATOR=MEMBER1 
FOPTIONSC004005)=KSAM, :FILE, NOCCTL, F, FILENAME, ASCII, PERM 
AOPTIONS€C010404)=AS IS, NOBUF, DEFAULT, NO FLOCK, NO MR, INOUT 
RECSIZE:SUB:TYP:LDNUM:DRT:UN.: CODE:LOGICAL PTR: END OF FILE:FILE LIMIT 
= Fae & 3: 0: er at Os us Lé OF 1023 
LOG. COUNT:PHYS. COUNT:BLK SZ:EXT SZ:NR EXT: LABELS:LDN: DISCADDR: 
Gs Os “fee 123% Ss 2:00000112326: 


= C1=FILE INFO, 2=KSAM PARAMETERS, 3=KSAM CONTROL, 4=ALL, S=NONE)?72 


REX FILE*KPILEKEY KEY FILE DEVICE=2 SIZE= 274 KEYS= 2 
FLAGWORDC000002)=RANDOM PRIMARY, FIRST RECORD=1, PERMANENT 
KEY TY LENGTH LOC. D KEY BF LEVEL 

1 B 1Z i3 * 100 0 

e 28 1 12 Y 202 0 


WHICH C1=FILE INFO, 2@=KSAM PARAMETERS, 3=KSAM CONTROL, 4=ALL, S=NONE)?5 


PEXIT 2 (= Enter a 5 to terminate VERIFY command and then terminate 
KSAMUTIL with an EXIT command. 
END OF PROGRAM 


ISAT I ee VR ED PE UI ES GSS ESE WA MI TAN AED PR AIT GS EMAAR WP TREY ENE NR NES ES a 


SE EEE HKR RRA HTHEHREREHBEeBeBaeaeagabaukwawa 
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In the example the following data file characteristics are specified: 


@ record size of 72 characters 

® blocking factor of 1 logical record per block 
® fixed-length records 

@ ASCII data format. 
6 


the first logical record in the file is to be referenced as record 1 
(;FIRSTREC=1) 


Default values are accepted for all other file characteristics. 


In addition to the data file name, a key file name and at least one 
key field must be specified. In the example, a primary key (the 
first key entered) and an alternate key are specified. 


@ The primary key begins in character position 13 and is 12 char- 
acters long. 

@ The alternate key begins in character position 12 and consists of 
1 character. 

Both keys are type B (character or byte) and both keys allow du- 

plicate values of the key to be entered in different records of the 

data file. 


The VERIFY command provides the following information when 
you select option 1 (FILE INFO): 


@ file name (data file name, group name, account name) and 
creator’s user name 

@ FOPTIONS: the file characteristics specified in the FOPEN 
intrinsic when the file is opened. See the MPE /ntrinsic Refer- 
ence Manual for a description of the foptions. 

@ AOPTIONS: the file access options specified in the FOPEN 
intrinsic when the file is opened. See the MPE /ntrinsics Refer- 
ence Manual for a description of the aoptions. 

@ RECSIZE: number of characters (negative) or words (positive) 
in record 

@ SUB: device subtype 

@ TYP: device type 

@ LDNUM: logical device number 





DRT: Device Reference Table number 

UN.: the hardware unit number of device 

CODE: the file code 

LOGICAL PTR: the number of the logical record to which the 

pointer is currently pointing 

@® END OF FILE: location of end of file (currently record 0). 
Note that MPE references the first record as record O and 
KSAM references the first record as record 1 as requested in 
this example with the FIRSTREC=1 parameter. 

@ FILE LIMIT: number of logical records that can be included 
in the data file. 

@® LOG. COUNT: number of logical records passed to and from 
user during the current access to the file. 

@® PHYS. COUNT: number of physical input/output operations 

performed within this process since the file was opened. 


BLK SZ: block size in words (positive) or characters (negative) 
EXT SZ: the size of each extent in sectors 

NR EXT: the number of extents to be allocated for the file 
LABELS: the number of user labels defined for the file 

LDN: logical device number 

DISCADDR: address on disc where first record in file is stored 


If you select option 2 (KSAM PARAMETERS) of the VERIFY ‘ 


command, information is printed about each key. The primary 
key is listed first. The information includes: 


@® the key number 

@ the key type (in this example both keys are type B) 

@ the length of the key in characters 

® the location, or character position, of the first character in the 
key 

® a flag to indicate whether or not duplicate values are allowed (Y 
indicates yes, N indicates no) 


® maximum number of keys per block 


ADDITIONAL INFORMATION: 
KSAM/3000 Reference Manual 
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copying an MPE file to a KSAM file 


wo 


You can use the FCOPY utility program to copy an MPE file to a 
KSAM file but the KSAM file must first be created with the 
KSAMUTIL BUILD command. 





eRUN FCOPY.PUB SYS em Initiate FCOPY execution. 
HP32212A.1.03 FILE COPIER CC) HEWLETT-PACKARD CO. 1976 


>FROM=EMPLOYEE;  TO=KFILE <= Copy contents of MPE file named EMPLOYEE to the KSAM file 
created in the last example named KFILE. Note that to reference 


EDF FOUND IN FROMFILE AFTER RECORD 19 the data and key file, only the data file name need be used. 


20 RECORDS PROCESSED ### Q ERRORS 





FCOPY copies the data from the EMPLOYEE file to the KFILE 
and at the same time generates and writes the necessary key infor- 
mation to the key file named KFILEKEY. 


ADDITIONAL INFORMATION: 


KSAM/3000 Reference Manual 
FCOPY Reference Manual 
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copying a KSAM file to the terminal 


If you copy a KSAM file to another file and do not specify other- 
wise, the file is copied in ascending order according to the value 
of the primary key data field. 


-RUN FCUPY.PUB.SYS <== Initiate FCOPY execution. 


HP32212A.1.03 FILE COPIER CC) HEWLETT-PACKARD CO. 19376 


ie Copy from KFILE to terminal (omit TO-file name) 
>FROM=KFILE;TO= 


142-67-SS335ALEXANDER GEOFFREY N 702 CORVALLIS DR.SCRMSSF45000 O1000YN 


527-58-31101BOWERS SUSAN A 13 OAKWOOD DRIVE SC FSHF 400 1 OYY 
212-83-95432F ERGUSON KATHERINE L729 UNION AVENUE LG FMSF22000 0 OY Y 
4S6-97-00543GDMEZ ROBERT D 1331 POETT LANE SCLMMSF27000 e2 OYY 
531-66-77771HORN MICHAEL S 2230 BRONSON AVE.SJ MMSF22000 1 ONY 
432-11-92012HOUGHTON MARGE S&S 313 MOONBEAM WAY LA FSHF 450 1 ONY 
244-75-38445JENSEN HILDA A 17650 SHADOW LANELG FMHF 1000 0 800YY 
300-24-366649SJUNG DIANA T 965 WINCHESTER SCLFMHP 3850 é@2 OYY 
333-44-82825KONIGSBERG JOANNE MM 4S ELDEN STREET LA FMSF15000 e ONY 
S37-58-234S54MAC LEAN VINCENT T 819 PALO ALTO ST.MV MMSF15000 5 OYY 
466-39-443340R02ZCD0 JOSEPH I 112 BRIGHTEN AVE.MVY MMHP 800 e2 OYY 
0939-23-51 02S05SC00D JOSEPH K 4567 CALIF. ST. MV MSHF 450 3 Ov 
253-48-00033PAPADAKIS JAMES L 1347 KINGSWORTH CU MMSF20000 3 OY 
G6/78-99- 33444PARK RICHARD R 1290 FRIAR WAY CU MSHF 400 1 OYY 
499-73-82472PlERCE EMMA R 460 SARATOGA AVE.SCLFMSF20000 e2 OY T 
342-48-83295SPOWELL PATRICIA J 249 FREMONT AVE. LA FMHF 1000 4 OYY 
138-66-09021RICHARDS NORMAN A 1961 MULBERRY DR.LG MMSF35000 4 ONY 
589-24-21124SCRUGGS RODNEY X 76 AUBURN DRIVE CU MMHP- 800 1 OYY 
275-886-292 75SP 1EOLE ROSALIE I 22 N. SRD STREET SJ FSSF35000 0 750T¥ 
Zee" 11-259 74YEE JANICE K 310 BEEKMAN PLACECU FSSF27000 0 OYY 


EOF FOUND IN FROMFILE AFTER RECORD 19 


20 RECORDS PROCESSED #*# 0 ERRORS 
Primary key ts last name 
Se ee en Gy SRI He ie eI TL aA ea eng MRT ee Sa aE SCS COR Syst Wea Uae Se eens ee cu ee 
The contents of the KFILE are displayed on the terminal in ascen- 
ding order of employees’ last names. The primary key is the default 
key for sequential processing. 
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if you include the KEY= parameter in the FROM= command, the records are copied according to the values of the alternate key that 
records are copied according to the ascending order of the key that begins in character position 12. 
begins in the specified character position. In the next example, the 





‘RUN FCOPY.PUB.SYS és Copy from KFILE to terminal according to the key beginning in 
>FROM=KFILE;TO=;KEY=12 character position 12. 
character position 12 
S27=-58-31101 BOWERS SUSAN A 13 DAKWOOD DRIVE SC FSHF 400 1 OY Y 
138-66-09021RICHARDS NORMAN A 1961 MULBERRY DR.LG MMSF35000 4 ONY 
S531-66-77771HORN MICHAEL S 2230 BRONSON AVE.SJ MMSF22000 1 ONY 
432-11-92012HOUGHTON MARGE §S 313 MOONBEAM WAY LA FSHF 450 1 ONY 
499- 73-8249 /e2ePIERCE EMMA R 460 SARATOGA AVE.SCLFMSF20000 2 OY y 
e1e~-3o~-254 3eF EEGUSUN KATHERINE L729 UNION AVENUE LG FMSF22000 0 OYY 
089=23-510230SGU0D JOSEPH K 4567 CALIF. ST. MV MSHF 450 3 OY 
253-48-00033PAPADAKIS JAMES L 1347 KINGSWORTH CU MMSF20000 3 OYY 
456-97-00543G0MEZ ROBERT D 1331 POETT LANE SCLAMSF27000 2 OYY 
678-99-33444PARK RICHARD R 1290 FRIAR WAY CU MSHF 400 1 OYY 
S37-58-234S54MAC LEAN VINCENT T 819 PALO ALTO ST.MV MMSF1S5000 S&S OYY 
3oo- 1 )= 353 74YEE JANICE K 310 BEEKMAN PLACECU FSSF27000 0 OYY 
466-39-443340R02ZC0 JOSEPH N 112 BRIGHTEN AVE.MV MMHP 800 e OYY 
S89-24-21124SCRUGGS RODNEY X 76 AUBURN DRIVE CU MMHP 800 1 oyvy 
300-24-36664JUNG DIANA T 965 WINCHESTER SCLFMHP 650 2 ov? 
275-86-39c755PIECGLE ROSALIE [ @2 N. 3RD STREET SJ FSSF35000 0 /SO0YY 
» 333-44-828e2SKONIGSBERG JOANNE M 45 ELDEN STREET LA FMSF15000 2 ONY 
JF142-67-SS33S5SALEXAHDER GEOFFREY N 702 CORVALLIS DR.SCRMSSF45000 O1000YN 
o42~48-83295P0WELL PATRICIA J 249 FREMONT AVE. LA FMHF 1000 4 0YY 
244-75-38445 JENSEN HILDA A 17650 SHADOW LANELG FMHF 1000 0 800YY 


EDF FOUND IN FROMFILE AFTER RECORD 19 


20 RECORDS PROCESSED ### Q ERRORS 
PSST TET SS 2 
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You can also copy a subset of the file by specifying a particular 
key and a value for the key. In the next example, only records with 
the character 4 beginning in position 12 are copied. 


>FROM=KFILE; TO= - SUBSET=""4" ,12 axa Copy from KFILE to terminal according to alternate key. 
300-24-36664JUNG DIANA T 965 WINCHESTER SCLFMHP 850 2 O0YY 
537-S8-23454MAC LEAN VINCENT T 819 PALD ALTO ST.MV MMSF15000 5 OYY 
466- 39-443340RO02ZC0 JOSEPH N 112 BRIGHTEN AVE.MV MMHP 800 e2 OYY 
678-99-33444PARK RICHARD R 1290 FRIAR WAY CU MSHF 400 1 CYy 
S589-24-21124SCRUGGS RODNEY X 76 AUBURN DRIVE CU MMHP 800 1 OYY 
Sco =11=S58747EE JANICE K 310 BEEKMAN PLACECU FSSF27000 0 OYY 


EOF FOUND IN\FROMFILE AFTER RECORD 19 


G RECORDS PROCESSED ##2# Q ERRORS 


character position 12 


ADDITIONAL INFORMATION: 


FCOPY Reference Manual 
KSAM/3000 Reference Manual 
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changing the name of a KSAM file 
5 


You must use the KSAMUTIL program to change the name of a 
KSAM file. If both the data file and the key file names are to be 
changed, you must use the KSAMUTIL RENAME command twice. 


>RUN KSAMUTIL.PUB.SYS <= Initiate KSAMUTIL execution. 
HP32208A.00.00 FRI, FEB 4, 1977, 2:28 PM 

>RENAME KFILE,KEMPLOY <== Change the name of KFILE to KEMPLOY. 
yRENAME KFILEKEY,KEMPKEY em Change the name of KFILEKEY, to KEMPKEY. 
>VERIFY KEMPLOY «sm Display file information. 


WHICH C1=FILE INFO, 2=KSAM PARAMETERS, 3=KSAM CONTROL, 4=ALL, S=NONE)D?1 


KEMPLOY.GROUP1.PAYACCT CREATOR=MEMBERT 
FOPTIONSCO0400S)=KSAM, :FILE, NOCCTL, F, FILENAME, ASCII, PERM 
ADPTIONSC010404)=AS IS, NOBUF, DEFAULT, NO FLOCK, NO MR, INOUT 
RECSIZE:SUB:TYP:LDNUM:DRT:UN.: CODE:LOGICAL PTR: END OF FILE:FILE LIMIT 
a7Fee Se Qi: 2's Ss 0: bs ti eo: 1023 
LOG. COUNT:PHYS. COUNT:BLK SZ:EXT SZ:NR EXT: LABELS:LDN: DISCADDR: 
Z- : = at levs =e 1: 2:00000112326: 


WHICH €1=FILE INFO, 2=KSAM PARAMETERS, 3=KSAM CONTROL, 4=ALL, S=NONE)D?2 


WKEY FILE=KEMPKEY KEY FILE DEVICE=e2 SIZE= e74 KEYS= < 
FLAGWORDC000002)=RANDOM PRIMARY, FIRST RECORD=1, PERMANENT 
KEY TY LENGTH LDC. D KEY BE RESVD 
1 B 12 13 ¥ 100 0 
2 8B 1 le ¥ 202 0 


WHICH €1=FILE INFO, 2=KSAM PARAMETERS, 3=KSAM CONTROL, 4=ALL, S=NONE)?5 


SA Sa AN TE Ve EE es Te 
As you see by using the VERIFY command, the KEMPLOY file 

is the same file and has the same characteristics as KFILE. Its key 

file is KEMPKEY rather than KFILEKEY. Do not use the MPE 

‘RENAME command. 

ADDITIONAL INFORMATION: 

KSAM/3000 Reference Manual 
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deleting a KSAM file 


To delete a KSAM file, use the KSAMUTIL program PURGE 
command. 





-RUN KSAMUTIL.PUB.SYS <= Initiate KSAMUTIL execution. 


HP32208A.00.00 FRI, FEB 4, 1977, ezseo PM 
== Delete the KEMPLOY file. 
Note that the key file KEMPKEY associated with the 


>PURGE KEMPLOY KEMPLOY data file is also deleted. 
KEMPLOY.GROUP1.PAYACCT & KEMPKEY PURGED. 
>EXIT 


END OF PROGRAM 





You can also purge a temporary KSAM file by including the param- 
eter ,TEMP. 


The MPE :PURGE command may be used but you must enter it 
twice, once for the data file and once for the key file. 


ADDITIONAL INFORMATION: 
KSAM/3000 Reference Manual 
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glossary 








account 


account level 
security 





account librarian 





account manager 


actual file 


q 
q account member 
I designator 





allocating 


alphanumeric 
character 





ASCII data 


ASCII files 


” back reference 


back up 


batch mode or 
processing 


BCD 


binary data 


bit 








The basic unit to which resources are assigned and the major billing entity to which system resources such as central 
processor time, on-line connect time and file space are allocated and charged. 


The file access modes and types of users to whom they are available as specified by the system manager when the 
account is created. 


A user who is granted special file-access modes by the account manager for maintenance of files within the account. 
There may be more than one account librarian per account. 


A user who manages the account by defining valid users and file groups and specifying resource-use limits (if any) 
for them. 


Anyone for whom the account manager defines a user name and attributes. 


The name by which MPE recognizes a devicefile or a disc file. 


The system process of locating and reserving disc space to be used for a particular file. 

A character consisting of one of the alphabetic characters (A-Z) or the numeric digits (0-9). 

Data formatted in 7-bit characters conforming to the American Standard Code for Information Interchange. See table 
in the HP 3000 Software Pocket Guide. 

Files whose records are padded with blanks. 


The technique of using an asterisk before a file name to indicate that the file has been defined in a preceding :FILE 
command entered during the current session or job. 


Typically refers to copies of disc files residing on magnetic tape files. 


A technique of submitting to the system, as a single unit, commands requesting various MPE operations such as pro- 
gram compilation and execution, file manipulation, or utility functions. Each unit is called a job. 


Binary Coded Decimal. A decimal notation in which individual decimal digits are each represented by a group of 
binary digits. 


Data consisting of binary numbers. All available data types in the HP 3000 system can be coded as binary data. 


Acronym for binary digit. One binary digit (0 or 1). 
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block 
blocking factor 


buffer 


byte 


carriage control 
information 


CCTL 


closing a file 


cold load 


collating sequence, 
ASCII 


command 
COMP-3 
connect time 
Control A (A°) 
control key 
Control Y (Y°) 
CPU 


CPU time 


A group of one or more logical records transmitted to or from a file by an input/output operation. 
The number of logical records in a block. 


A storage device used to compensate for a difference in rate of flow of data, or time of occurrence of events, when 
transmitting data from one device to another. 


An area in which information is temporarily stored during a transfer of information. 
A sequence of 8 bits operated upon as a unit. One-half an HP 3000 word. 


Directions about the formatting of data on a line printer or terminal, specifically the way in which line feeds and 
Carriage returns are to be handled. 


A parameter of the :BUILD and :FILE commands that tells MPE that the program will provide carriage control 
information. 


Terminating access to a file after completing all input/output operations with the file. Accomplished by calling the 
FCLOSE intrinsic or terminating program execution. 


The process of loading the MPE system from the system disc to memory. This is the standard operating procedure 
for starting a system after it has been shut down. 


The sequence into which the ASCII characters are sorted or ordered (based on the numeric value of the 7 bits that 
represent the character). 


A key word that directs MPE, a subsystem, or a utility program to perform a specific operation. 

A term used in the COBOL programming language to refer to the packed decimal data format. 

The amount of time between the beginning and ending of a session. 

A character entered by pressing the control key and holding it down while pressing the A key. 

A special key on terminals used in combination with other keys to create a special character. 

A character entered by pressing the control key and holding it down while pressing the Y key. 

Central processing unit of the computer, its arithmetic unit and registers. Sometimes called the main frame. 


The amount of time a user, group, or account has used the central processing unit. 
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ie ca cll al pol aeons i onion len 





+s 











creator, file 


CTRANSLATE 





data base 





:DATA command 





defaults 





device class name 





device subtype 





device type 








device-independent 


K) devicefile 








direct access 


EBCDIC 





| Editor 


SI escape key 


execution state 








User who creates file with the :BUILD command or FOPEN intrinsic (identified by user name, account, and log-on 
or home group). 


An MPE intrinsic that converts a string of characters from EBCDIC to ASCII and vice versa. 
A collection of logically-related files containing both data and structural information. 
An MPE command that defines a devicefile for the input of information coded on cards. 


Values for parameters or various system characteristics that take effect if a parameter is omitted or a characteristic is 
not specified. 


A name consisting of up to 8 alphanumeric characters, beginning with a letter, defined by the system supervisor and 
assigned to one or more devices of a particular type when the system is configured. 


A number ranging from 0 to 15 defining a specific device and software driver. (See next entry.) 


A number defining a particular type of device, for example, O=moving head disc. See the System Manager/System 
Supervisor Reference Manual for a list of the various device types and subtypes. 


The characteristic of files referenced by programs to be run on the HP 3000 that allows the type of file or device to 


be specified when the program is actually run. For example, a program file may be defined as a disc file for one execu- 
tion of the program and a tape file for another. The MPE file system determines the actual location of the file for you 


when you run the program. 


A file originating from or directed to a non-disc device. A file currently being input to or output from any peripheral 
device except a disc. 


Reading from or writing to a random access device (usually a disc) by addressing a specific logical record. 


Extended Binary Coded Decimal Interchange Code. An 8-bit code representing an extension of BCD. Can represent up 
to 256 characters. 


The HP 3000 text editor, EDIT/3000, used to create and manipulate ASCII files. 
A special key on terminals, usually identified by the letters ESC, that changes the terminal into a different mode. 
When followed by a semi-colon (;) it disables the MPE Echo Facility, preventing the characters you enter from being 


displayed. When followed by a colon (:) it enables the Echo Facility again. 


A term referring to a program's mode when it is actually running on the system. 
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extent 

FCLOSE intrinsic 
FCOPY 

FID 


file 


file code 


file creator 


file directory 


file information 
display 


file label 


file level security 


file pointer 


File System 


fixed-length record 


FOPEN intrinsic 


A portion of a file consisting of contiguous sectors on the disc. 

An MPE system-supplied intrinsic that is used to close a file. 

The HP 3000 file copier, one of the utility programs supplied with your system. 
File Information Display (see below). 


A collection of related records treated as a unit. An HP 3000 file may be an MPE disc or devicefile, a KSAM disc 
file, or an IMAGE data set. 


A four-digit integer that identifies the special function of a file. You may assign a file code between O and 1023 to 
a file you create to classify it according to its purpose. The system uses number 1024 through 1070 for special 
system files. (See the filecode parameter of the :FILE command in the MPE Commands Reference Manual for a 
list of these file codes.) 


See creator. 


A catalog maintained by the system to record the names, creators, locations, and other characteristics of files known 
to the system. 


A display of file characteristics, an error message, an error number, and current FOPEN intrinsic parameters that 
is provided when certain file input-output errors occur. (See the Error Messages and Recovery Manual for a 
description.) 


The first sector of a disc file. Contains information about the file such as the information displayed when you enter 
a :LISTF name,2 command. (See the MPE Commands Reference Manual, table 6-13 for a list of the label contents.) 


The file access modes and types of users to whom they are available. These are determined by default when the file 
is created and may be changed by the file creator using the :ALTSEC command which is described in the MPE Com- 
mands Reference Manual. 


Logical record pointer kept by MPE to indicate the next sequential record to be accessed in a file. Pointer is set to 
the first record when the file is opened. 


The part of the MPE operating system that automatically handles user access to input/output devices and data block- 
ing, buffering, data transfers, and deblocking. 


A record that always contains the same number of characters or words. 


An MPE system-supplied intrinsic that is used to open a file. 
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foptions 
parameter 


formal file 
designator 


FITNoan 





fully-qualified 
file name 





group 








group level 
security 





group user 





hard-wired 
terminal 





home group 
J IMAGE 


intrinsic 


job 





) job control 
commands 


key 


key word 





A parameter of the FOPEN intrinsic that is used to specify different file characteristics. (See the MPE Intrinsics 
Reference Manual for a description of these characteristics.) 


The name by which a program recognizes a file. 


The formal file designator for a FORTRAN program’s file. 


A file name qualified by the name of the group and account to which the file belongs, for example, FILEX.GROUPX. 
ACCOUNTX. 


A bookkeeping facility that partitions some of an account's file domain and resources into a private sub-domain. The 
on-line connect-time, central processor time, and disc-file space that you use are charged to your log-on group as well 
as account. 


The file access modes and types of users to whom they are available as specified by the account manager when the 
group is created. 


A user who is logged on to a particular group, or who is assigned the group as a home group. 

A terminal directly connected to the computer system. 

The group assigned to a user by the account manager when he defines the user name. This group is the user’s de- 
fault log-on group if a group name is not specified with the :HELLO or :JOB command. 


A data base management system available on the HP 3000 consisting of a set of programs and procedures that can be 
used to define, create, access and maintain a data base. 


An operating system procedure used to access and alter files, as well as to perform other operations. 


A single unit of commands that request various MPE operations such as compiling and executing programs, manipu- 
lating files, or performing utility functions, submitted by the user to the HP 3000. 


MPE, subsystem, and utility commands submitted as part of a job. A set of these commands must begin with a -JOB 
command and end with an :EOJ command. 


A user-defined field within a data record. The value of the key field can be used to locate and access the particular 
data record. 


A word that has been assigned a specific meaning by the system. 
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KSAM 


LISTDIR2 


LISTEQ2 


local attribute 


lockword 


log on 


log-on group 


logical device 


number 


logical record 


MERGE 


modem 


MPE 


MPE defaults 


$NEWPASS 


NOCCTL 


Keyed Sequential Access Method, a file access method for the HP 3000 Series I! computer system in which records 
may be accessed sequentially or randomly by primary or alternate key value. 


An MPE utility program that lists information about accounts, groups, users and files. 


An MPE utility program that lists the MPE :FILE commands used, and temporary files created, during the current 
session or job. 


A doubleword number defined by system or account managers and used by accounts or groups for any purpose 
desired. A local attribute may be accessed in a program through the WHO intrinsic. 


A word assigned to a file when it is created that must be supplied to access the file in any way. The word may be 
from one to eight alphanumeric characters long and must begin with an alphabetic character. 


The process of initiating a session with the MPE operating system by using the :HELLO command or initiating a job 
with the :JOB command. 


The group you select at log-on time for your local file domain. You must specify a group with the :HELLO or :JOB 
command, unless you have a home group in which case it is the default log-on group. 


A unique number in the range of 1 to 255 that the system supervisor assigns to a device when the system is con- 
figured. 


A collection of fields or related data treated as a unit, residing in a file. 
See SORT. 


A modulator-demodulator device that provides the appropriate interface between a communications link (such as a 
telephone) and the computer. 


The Multiprogramming Executive operating system of the HP 3000 computer systems. 


Values for parameters or various system characteristics that take effect if a parameter is omitted from an MPE com- 
mand or intrinsic. 


A system-defined file name to be used when creating a special temporary file that can be referenced by a succeeding 
operation as $OLDPASS. 


A parameter of the :BUILD and :FILE commands that tells MPE that the program wiil not provide carriage control 
information. 
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permanent file 


If 








$NULL 


offline state 


$OLDPASS 
opening a file 
optional parameter 
output priority 
parameter 


PARM= parameter 


password 






physical record 


process identifica- 
tion number (PIN) 


production mode 


PUB group 


record 


relative record 


A system-defined file name that tells MPE to accept input or direct output to a dummy or “ghost” file, for example, 
output normally directed to a line printer can be discarded by writing it to a $NULL file. 


The state of a device when it is not available to the system. 


A system-defined file name to be used when referencing the temporary file most recently created with the name 
SNEWPASS. 


Initiating access to a file before beginning input/output operations with the file. Accomplished by calling the FOPEN 
intrinsic. 


‘Parameter that is not required when entering a command or calling an intrinsic. In reference manuals, optional param- 


eters are surrounded by brackets, [ |. 


A number in the range of 1 (lowest priority) to 13 (highest priority) assigned to a file with the :FILE command. It is 
used to determine which spooled devicefile of all those waiting for a specific printer or card punch should be selected. 


A variable assigned a constant value for a particular purpose or process, used in commands and procedure calls to re- 
quest specific action. 


A :RUN command parameter that passes a value to the program that can be used for control or other purposes. 


A word, consisting of at most 8 alphanumeric characters beginning with an alphabetic character, assigned to an ac- 
count, group, or user name when it is defined. A password must be supplied when accessing an account or group, or 
logging on with a user name for which a password is defined. 


A disc file that is saved and whose name is in the system directory until it is deliberately purged from the system. 
In MPE terminology, a block of logical records. 


A number assigned to a process by the operating system when the process is initiated. The number is used to com- 
municate information about the process to the console operator. 


The environment in which programs and jobs are being run to produce actual data rather than test data. 


A special group that exists in each account whose files are normally accessible in some way to all users within the 
account. 


See logical record. 


A number that represents the position of a logical record in relation to the first record in the file. The first record is 
numbered either O or 1 depending on the subsystem or utility being used. 
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run-time 


save access to 
a group 


sector 
security 


sequential access 


session 


session/job 
file directory 


session/job 


temporary file 


SORT 


spoofle 


spooled device 


spooling 


$STDIN 


$STDINX 


$STDLIST 





The environment in which a program is running or executing. 


The capability of making a file a permanent file on the system. 


A portion of a track on a disc device; the smallest addressable piece of the disc. 


wa Hices Mies Mw: Mie: Ms Me Be 


The provisions made by MPE to protect accounts, groups, files, and user names from unauthorized use. 


Reading from or writing to a device by accessing the records in consecutive order. This is the only type of access avail- 
able with non-disc devices. 


A mode of using the HP 3000 interactively, entering commands and data through a keyboard terminal and receiving 
immediate responses to your input. A single session begins when a :HELLO command is entered and ends when a 
:BYE command or another :HELLO command is entered. 


= 


A directory maintained by MPE that contains the names of temporary files created during a session or job that are to 
be deleted when the session or job terminates. 


A temporary file that is to be deleted when the session or job terminates. 


The HP 3000 sort/merge program that allows you to sort records in a file into a prescribed order and to merge records 
by combining two or more previously sorted files into one sorted file. 


A spooled devicefile, a file read from or directed to a spooled non-sharable device, such as a card reader or line printer,¢ 
and temporarily written on the disc. 


A device on which spooling has been enabled. 


A facility to assist in the sharing of devices. The data coming from or going to a spooled device is copied by MPE toa 
disc and, in the case of output files, directed to the device when it is free. The records of spooled input devices are 
read in immediately, written to disc, and made available to the program as it requests them. 


A system-defined file name that refers to the terminal on which a session is initiated or the device from which a job 
is initiated, (a card reader, tape, or terminal). 


A system-defined file name for the session or job input device. When this file name is used, some MPE command 
images may be read as part of a data file. 


A system-defined file name that refers to the standard session or job listing device (usually the terminal on which a 
session is initiated and the line printer for a job). 


Sa 2 ale ee oe oe a 
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stream, job 





“Fy subqueue 
priority 





subsystem 





SYS account 





system 
configuration 





system console 





system file 
directory 





system manager 


system supervisor 


Msystem-defined 
files 





Z| system-file-name, 
COBOL 





Systems Engineer 
i temporary file 


undefined-length 
records 








user name 








A set of job control commands and data delimited by a :JOB command record and an :EOQJ command record, read 
into the system and scheduled for execution by using the :STREAM command. 


A category assigned to a process (an executing program) when it begins that determines how it will compete with 
other processes for access to the central processor. (See the System Manager/System Supervisor Reference Manual 
for a description of the available subqueues.) 


A term referring to software packages that perform specific functions such as compiling programs or editing text. 


A special account that is present on the system when it is delivered. It contains system files, the system Segmented 
Library, and supported subsystems such as the compilers. 


The process of modifying the operating system provided by the factory to suit the needs of your installation. (See the 
System Manager/System Supervisor Reference Manual for a description of this process.) 


A terminal through which an operator initializes and monitors the MPE operating system and requests various opera- 
tions such as allocating devices, sending messages to user terminals, and shutting down the system. 


A directory maintained by MPE that records the name, group, and account of each permanent file on the system as 
well as other file information. 


A person who manages the overall system by creating accounts and defining resource-use limits for each account. 


A person who manages the system on a day-by-day basis, scheduling queues, altering the system configuration, main- 
taining the system library, and displaying various items of system information. 


Files defined by MPE and made available to all users to indicate standard input or output devices. 
A parameter of the COBOL SELECT statement ASSIGN clause. . 


An HP technical software specialist. 
A file that exists only during the period in which a program has the file opened or the duration of a session or job. 


A record whose size varies and is only defined in terms of the maximum size allowed. Files with undefined records 
must have a blocking factor of 1 and the records are written without buffering. 


The formal name by which the system identifies a person and knows what capabilities the person is authorized to use 
on the system. 
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utility programs 
variable-length 
records 

WHILE block 
word 


word offset 
numbers 


work file, Editor 





Programs provided by MPE to perform specific functions for you. (See the MPE Systems Utilities Reference Manual 
for a description of these programs.) 


Records that vary in size with respect to each other. 


A set of three Editor commands beginning with a WHILE command, executed repeatedly. 
16 bits or 2 bytes of information in the HP 3000 system. 


The number of words a location is removed from a base address. 


A file used by the Editor that contains the information being modified. 
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| A (add) file access, 14 


AC (account user), 14 
accept jobs, sessions, data, 5 
access capability, file, 35, 36 
access 

direct, 9 

sequential, 9 
account, 12° 

defining, 18 
accounting information, 109, 111, 115 
account manager, 109 
account structure, 12 
actual file designator, 4 
ADD Command (Editor), 28 
advantages, :BUILD vs. :FILE, 26 
AL (account librarian), 14 
all files in group, copy, 94 
allocating disc space, 8 
alternate key (KSAM), 128 
-ALTSEC Command (MPE), 14 
ANY (any user), 14 
appending to file, 76 
application, testing, 85 
ASCII, 9, 70 

to EBCDIC, 68 

files, combine using Editor, 55 


} assign lockword, 37 
~ asterisk 


as TO-file (FCOPY), 53 
to back reference, 42 
at-sign, use in MPE commands, 94 


backup tape or serial disc 

copy files to, 93 

copy files from, 95, 96 
back reference :FILE, 42 
BASIC default file characteristics, 25 
BCD (Binary Coded Decimal), 9, 68 
binary data in files, 9 
blocks, 8 


-BUILD command (MPE), 21 
differences from :FILE, 26 
TEMP parameter, 30 

BUILD command (KSAMUTIL), 127 


capability, file access, 35, 36 

creator, 15 
card reader 

device class, 42 

devicefile, 42 

spooled, 42 
cards, job control, 77 
cards to disc, 41 
CHANGE (Q) command (Editor), 86 
change lockword, 37 
change name 

KSAM file, 133 

MPE file, 36, 63 
change specific data in file, 85 
characteristics of 

each device, 5 

Editor file, 28 

new file, 7, 8 
CHAR parameter (FCOPY), 46 
check job status, 81 
closing file, 7 
COBOL default file characteristics, 25 
code, file, 9, 55 
colon substitute in jobs, 75 
combine files, 53, 55 
:-COMMENT command (MPE), 75 
conditions in test file, 88 
connect time, 109 
console 

print message on, 75 

tape control, 45, 79, 94 

status message, 78 
-CONTINUE command (MPE), 82 
control A, use at console, 45, 79 
copy KSAM file 

by key, 131 

to terminal, 130 


copy MPE file 

ASCII to EBCDIC, 68 

cards to disc, 41 

EBCDIC to ASCII, 66 

from backup tape or serial disc, 95 

subset, 56 

tape to disc, 44 

to another 3000, 93 

to another account, 64 

to another group, 58, 62 

to backup, 93 

to KSAM file, 129 

to line printer, 46 
cpu time, 109 
creating a file 

:BUILD, 21, 100 

by copying another file, 27 

KSAM, 127 

on a volume set, 100 

specific characteristics, 23 

temporary disc, 30 

while program executing, 24 
creating conditions in test file, 85 
creator, file, 12, 58 

indent capabilities, 15 
CTRANSLATE intrinsic, 67, 68 


data, accept, 5 
data, changing in file, 85 
:DATA command (MPE), 41 
data elements, 8 
data file, KSAM, 16 
data files, maintaining current set, 82 
data, passing in temporary files, 83 
default 
:BUILD characteristics, 21 
card reader devicefile, 42 
file characteristics (by language), 25 
security requirements, 14 
TO-file, 46 
defining accounts, groups, users, 18 


deleting a file 
KSAM, 134 
MPE, 35 
DEL parameter (:FILE), 7 
describe job, 75 
determine logical device nos., 122 
DEV=parameter (:FILE), 96 
device class 
card reader, 42 
name, 5 
devicefiles, 5, 10 
determining id, 122 
information, listing, 122 
using, 10 
device independent, 4 
devices, non-sharable, 10 
differences, :BUILD vs. :FILE, 26 
direct access, 9 
directory 
system file, 30, 31 
job temporary, 30, 31 
disc files, 5 
names, 9 
disc space, allocating, 8 
disc to line printer, 46 
disguise lockword, 37 
display 
:-FILE definitions, 32 
store/restore files, 94 
dollar sign ($), 9 
domain, system and job/session, 31 


EBCDIC, 9, 78 

to ASCII, 66 
EBCDICIN parameter (FCOPY), 66 
EBCDICOUT parameter (FCOPY), 68 
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Editor (EDIT/3000), 28, 55 


commands 
ADD, 28 
CHANGE (Q), 85, 86 
EXIT or END, 28 
FIND (Q), 86 
JOIN (Q), 55 
KEEP, 28 
LIST, 29 
SET 
LEFT=, 86 
LENGTHe=, 29 
SHORT, 86 
SIZE, 55 
TEXT, 29 
WHILE, 86 
create conditions in test file, 85 
file characteristics, 28 
repeat two commands, 86 
work file, 55 
END command (Editor), 28 
end-of-file pointer, 22 
end of job, 76 
-EOD command (MPE), 41 
:EOJ command (MPE), 76 


, ERRn, 17 
y error message, 17 
errors, continue job, 82 


escape key, 37 

examining test file, 88 
exclamation point in jobs, 75, 78 
EXEC job status, 81 

executing job from file, 78 

EXIT command (Editor), 28 
extents, 8 


FCLOSE, 7 
FCOPY, file copier utility, 27 
CHAR parameter, 46 
EBCDICIN, 66 
EBCDICOUT, 68 
KEY, 131 
NORECNUM, 46 
SKIPEOF, 66 
SUBSET, 47, 56, 66 
TO-file not specified, 88 
FGETINFO intrinsic, 9 
file characteristics, KSAM, 128 
file closing, 7 
file code, 9, 55 
file creator, 12, 58 
file domain, 31 
file identification, 9 
file information display, 17 
file information listing, 119, 121 
file label 
system, 9 
user, 9 
file name, 9, 21 
fully-qualified, 13 
file security, 12 
file status (SSTDIN), 122 
file system, 4 
files, how accessed, 7 
:FILE command, 10, 24, 47 
ACC=APPEND, 76 
DEL, 7 
differences from :BUILD, 26 
display, 32 
NEW, 7, 24 
OLDTEMP, 83 
SAVE, 7, 24 
TEMP, 7, 83 
FIND (Q) command (Editor), 86 
fixed length records, 8 
FOPEN intrinsic, 7 
KSAM, 127 
formal file designator, 4 


FORTRAN default file characteristics, 25 
FROM-file (FCOPY), 27, 43 
fully-qualified file name, 13 
function of job, describe, 75 


ghost file, 10 
group, 12 
backup all files in, 94 
copy file to, 62 
defining, 18 
home, 18 
list information about, 111, 116 
S (save) access, 58, 63 
transfer file to, 63 
GU (group user), 14 
‘HELLO command, (MPE), 13 
HELP command (LISTDIR2), 112 
home group, 13, 18 
home volume set, 99 
how files are accessed, 7 


identification, file, 9 
information about (display) 
devicefile, 122 
spooled file, 122 
inhibit display of commands in WHILE block, 87 
INPUT command (SORT), 69 
input devicefile information, 122 
intrinsics, MPE, 7 
?1/O/console message, 45, 79, 94 


-JOB command (MPE), 13, 75 
production job, 75 
job, continue despite errors, 82 
job control commands, 28, 75 
describe job, 75 
executing from file, 28, 75 
in cards, 77 
substitute for colon, 75 
job/session file domain, 31 
job status, 81 
job temporary file directory, 30, 31 
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jobs, accept, 5 
JOIN(Q) command (Editor), 55 


KEEP command (Editor), 28 
KEEP parameter 
>-RESTORE command, 95 
‘STORE command, 93 
KEY parameter (FCOPY), 131 
key file, 16, 127 
Keyed sequential access method, see KSAM 
keys, KSAM, 128 
KONVERT program, 67 
KSAM files, 16 
creating, 127 
change name, 133 
copy by key, 131 
copy to terminal, 130 
data file, 16 
data file characteristics, 128 
FOPEN intrinsic, 127 
MPE file to, 129 
NEW parameter, 129 
KSAMUTIL program, 16 
BUILD command, 127 
PURGE command, 124 
RENAME command, 123 
VERIFY command, 127 


labeled magnetic tape 
opening a file, 105 
reading a file, 106 
writing a file, 106 

labels, system, 9 

labels, tape, 105 

labels, user, 9 

line printer 
LISTDIR2 information to, 113 
number of copies, 49 
output priority, 49 
printing information on, 48 
sort records to, 70 
spooled, 49 
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LIST command (Editor), 29 
LISTACCT command (LISTDIR2), 115 
:-LISTACCT command (MPE), 111 
LISTDIR2 program, 111-121 





LISTEQ2 program, 32 
LISTF command (LISTDIR2), 119 
:LISTF command, 9, 21, 22, 48 
:LISTF command (MPE), 111 
listfile parameter, 48 
LISTGROUP command (LISTDIR2), 116 
:-LISTGROUP command (MPE), 111 
listing 
accounting information, 115 
devicefile information, 122 
file information, 119 
group information, 116 
record numbers of record with specific data, 89 
security information, 121 
user information, 117 
LISTSEC command (LISTDIR2), 121 
LISTUSER command (LISTDIR2), 117 
:LISTUSER command (MPE), 111 
L (lock) file access, 14 
lockword, 12, 35 


disguise, 37 
) assign, change, remove, 37 
— logical device number, 5 
determining, 122 
logical record, 8 
log-on 
account and group, 13 


maintaining set of production data files, 82 
making backup copies of disc files on tape or serial disc, 93 
margin, set left, 86 
messages | 
request short (Editor), 86 
to console, 45, 75 
warning (FCOPY), 47 
MPE, 4 
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MPE file to KSAM, 129 
MPE tape labels, 105 


name 
device class, 5 
file, 9, 21 
new file characteristics, 7 
NEW parameter 
FCOPY, 43, 129 
-FILE command, 24 
SNEWPASS file, 10, 84 
non-sharable devices, 10 
NORECNUM parameter (FCOPY), 46 
$NULL file, 10 
number of copies, 49 


S$OLDPASS file, 10, 84 
OLDTEMP parameter (:FILE), 83 
opening file, 7, 105 

OUTPUT command (SORT), 69 
output devicefile information, 123 
Output priority, 49 


packed decimal format, 67, 68 
passing data in temporary files, 83 
permanent files, 7 
physical characteristics of file, 7 
physical record (block), 8 
pointer, EOF, 22 
pointer, file 

set to beginning, 86 
:PREP command (MPE), 84 
preparing production job, 75 
primary key, KSAM, 128 
private volumes 

creating new file, 100 

mounting and dismounting, 101 
procedures, 7 
program executing, create file while, 24 
program, source, 28 
programming language defaults, 25 


PUB account, 14 
PURGE command, KSAMUTIL, 134 
:PURGE command (MPE), 35 


QUIET job status, 81 


R (read) access, 14 
to group, 58 
to account, 64 
record, logical, 8 
record, physical, 8 
record width, 5 
>RELEASE command (MPE), 14 
release file security provisions, 14, 64, 88 
remove lockword, 37 
RENAME command (KSAMUTIL), 133 
>-RENAME command (MPE), 36, 63, 82 
repeat two editor commands, 86 
=REPLY console message, 45, 79, 94 
:REPORT command (MPE), 109 
reporting On account and group resource use, 109 
request short messages, 86 
:-RESET command (MPE), 32 
:sRESET ACCT command (MPE), 115 
restore security provisions, 65 
-RESTORE command (MPE) 
KEEP parameter, 96 
SHOW parameter, 95 
restoring disc files from backup tape or serial disc, 95 
to particular disc, 96 
RPG default file characteristics, 25 


-SAVE command (MPE), 30 
S (save) access, 14 

to group, 36, 58, 63 
SAVE parameter (:FILE), 7, 24 
scanning for conditions set in test file, 88 
‘SECURE command (MPE), 14, 65 
security, listing information on file, 121 
security provisions, 12, 14 

release, 14, 64, 88 


restore, 65 

selectively load files, 96 
selectively restore files, 96 
sequential access, 9 
serial disc 

backup disc files, 93 

restore disc files, 95 
sessions, accept, 5 
session/job temporary file, 7 
SET command (Editor) 

LEFT, 86 

LENGTH, 29 

SHORT, 86 

SIZE, 85 
SETMSG OFF, 81 
set pointer to beginning of file, 86 
SHORT option (Editor), 86 
SHOW parameter 

:RESTORE, 95 

-STORE, 94 
:SHOWIN command (MPE), 122 
:SHOWJOB command (MPE), 81 
‘SHOWOUT command (MPE), 123 
SKIPEOF parameter (FCOPY), 66 
skip tape label, 66 
SORT program, 69 
source programs, 28 
space, allocating disc, 8 
special characteristics, creating file with, 23 
specific data, list records with, 88 
spooled file, 11 

card reader, 42 

information about, 122 

line printer, 19 
status message, console, 78 
ST/console message, 78 
$STDIN, 10 
$STDNIX, 10 
$STDIN file status, 122 
$STDLIST, 10 

TO-file default, 46 





PrePrPP eet eee ees 











ee ee ee ee ee ee 


lest ey wl 











-STORE command (MPE), 93 


SHOW parameter, 94 
store files to backup, 93 
-STREAM command (MPE), 28, 75, 78 
subtype, device, 5 
suppress 

display of lines, 86 

FCOPY information, 46 
SYS account, 14 
system 

console, see console 

defined files, 9, 10 

file directory, 30, 31 

file domain, 31 

file label, 9 
system-supplied procedures, 7 


tape label, skip, 66 

tape labels, MPE, 105 

tape to disc, copy, 44 

:TELLOP command (MPE), 75 
temporary disc file, creating, 30 
temporary file session/job, 7 
temporary files, 84 

S$NEWPASS and $OLDPASS, 84 
OLDTEMP, 85 

TEMP parameter, 83 


TEMP parameter (:BUILD), 30 


terminal, copy KSAM file to, 130 
test file 
creating conditions in, 85 
examining a, 88 
testing an application, 85 
TEXT command (Editor), 29 
TO-file (FCOPY), 27, 43 
asterisk, 53 
default, 96 
not specified, 89 
transfer files 
to another 3000, 93 
to group, 63 
type, device, 5 
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undefined length records, 8, 43 
user, 12 

defining, 18 

list information about, 121, 117 
user labels, 9 


variable length records, 8 

VERIFY command 
KSAMUTIL, 127 
SORT, 69 


warning message (FCOPY), 47 
WHILE command (Editor), 86, 87 
work file, Editor, 55 

W (write) access, 14, 35, 36 


X (run) access to files, 14 
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